


0 32128 74887 s 


Xcode 2: The Latest Fun With Qilartz Composer: How To < ^ 

In Cb"o#i Development Build Aik App With No Code Whatsoever! 


The'BifferenffifBetween 
Recess And l^ermlsslons 


Betting Started tUi 
Rutomatfit: Create 
Voiir.OM Custom 


Ghost In The,niachfne: j 
Using TigeriTOilhplify 
Rlt VouMmlfinf^asks 

DOuel^ng f^licatioii^ 
With^he Qiiicktim^ 
for Cocoa Kit Ar 


^^^8.95 US 
^^n.9S Canada 
RsSN 1067*8360 
Tinted In U.S.A. 



IHIKU 





f iYl 





HHnAJiJilJ 













































Taming the Tiger 



(to) Automet(fr 



SpiderWorks Bodks 

From our brain to your brain 

Timely, quality content from 
respected authors at a great 
price. Available in softcover 


print editions and eBooks. 



®cr STSore to ardei oulir a 



www.spiderworks.conn , 






Need to find something fast? 








FairCom’s 
c-tree Plus* 

embedded database eagine 
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the same application. 
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programming control, unmatched 
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Low TCO 
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Easy Deployment 
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Start indexing your data today! 
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Tiger Is Here ! 


Welcome to another great issue of MacTech, Tliis 
month our primary focus is on Tiger, Apple's latest 
release of Mac OS X. We’re very excited with all we 
have on hand for you this month. So without any 
further ado.... 

As always we get started this month with....(Getting 
Started of course!! Our Editor-ln-(-hief Dave Mark has 
put his MySQL exploration on hold for a month so he 
can share with us his excitement about Automator, his 
“favorite new toy”. Dave gives us a great intro to this 
exciting new Tiger technology and shows us how to 
begin building Actions and Custom Workflows. After 
reading Dave’s piece we can’t wait to begin digging 
more deeply into Automator ourselves! 

This month marks the return of Scott Knastcr to the 
pages of MacTech.After a short hiatus to work on several 
book projects for our friends at Wiley, Scott has brought 
us a great piece on a new Tiger (Xcodc 2.0) technology. 
Quartz Ca)mposer. Quartz Composer is a tool that 
provides the opportunity to explore Tiger’s great new 
Quartz graphics features and build ‘(compositions” we 
can turn into useful things, like QuickTime movies or 
screensavers. In Scott’s piece, Fun with Quartz 
Composer, he shows us how to use this new tool to build 
a cool screensaver.Welcome back Scott! We look forward 
to much more from you m the future!! 

Next up in our comprehen.sivc Tiger ctjverage we 
have a wonderful piece from our resident AppleScript 
guru Ben Waldie on all that’s new with Applescript in 
Tiger. While there’s much new in AppleScript for users, 
Ben turns his focus on the great new features in 
AppleScript for developers. We learned a lot from Ben’s 
piece and we’re sure you will as well! 

Turning our attention for a moment to things other 
than Tiger, we have a really informative piece on how 
designers can get truly creative with color in their site 
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development work by moving beyond the 2l6 colors in 
the “web-safe palette". Dean Wilcox, a great designer 
and artist who runs a shop in Sausalito called, 
appropriately enough, Wilcox Design, 
(www.wilcoxdesigns.com) shows us how we can 
greatly expand the use of color in our sites with a 
terrific Photoshop phig-in from Master C^olcir, 
(www.master-colors.com), HVC Color Composer, Great 
piece Dean! Thanks!! 

Also in the non-Tiger vein we have Part 11 of David 
Swain’s exploration of enterprise database 
development, Enterpri.se Information Systems on Mac 
OS X. If you missed Part 1 of David’s piece, get your 
hands on a copy of the March MacTech. David truly is a 
master of his domain. We look forward to David’s 
sharing much more of his great database development 
knowledge with us in the future.We’re sure you will tool 

Getting back to the theme of this month’s issue, 
Tiger, we have a couple of really informative pieces for 
our sysadmin types from our Unix and Open Source 
gurus, Ed Marczak and Dean Shavil. Ed’s Mac In The 
Shell this month focuses on Access Control Lists or 
ACLs, Ed shows us how to use this new addition to 
Tiger and Tiger Server to bring greater control to {>ur 
access and permissions management. Dean’s May 
installment ori he Source Hound focuses on Tiger’s new 
image management tools and how we can make our 
lives much easier, at least when it comes to building 
images and loads, or what is commonly referred to as 
“Ghosting”. Some of us here at Mac'I’ech wish we had 
Dean and Ed around when we were managing Macs in 
Enterprise environments. The knowledge they share 
with us each month sure would have given us mucli 
more time to play golf! 

For our Cocoa developers we have another great 
installment from all our friends at Big Nerd Ranch, 
(www.bignerdranch.com). This month Aaron Hillegass 
and his associates show us a bunch of stuff that’s new in 
Xcode 2, particularly a new feature called “All-In One 
Layout". Aaron, great to have you and BNR with us each 
month. Your Cocoa development knowledge is a great 
resource for our readers!! 

Rounding out our Tiger coverage is a .super piece 
from Apple Engineer and MacTech’s QuickTime god, 
Tim Monroe. In keeping with our Tiger theme, this 
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month Tim shows us how to build apps with the new 
QuickTime for Coca Kit.Tim’s sharing of his mastery of 
all things QuickTime has become a MacTech 
institution. We get as much feedback from Tim’s pieces 
as anything else we run in MacTech. It’s clear yt)u enjoy 
Tim’s great writing as much as we do. Be looking for 
much more from Tim in future issues of MacTech! 



Be sure to download the new 167-page Mac lech 
Sampler pdf from: 

http://www.mactech.com/sampler/ 

This sampler is bursting at the seems with great 
examples of what makes the new MacTech an 
invaluable resource for all Mac IT professionals. We are 
happy to share this great elssue with you. We’re sure 
you will find it useful and informative. 

As we go to press this month Apple has been 
creating huge excitement with its WWDC 
announcements, particularly with the move to stake the 
Mac’s future on Intel CPUs. Wc arc as interested as you 
are in Xcodc 2.1, Universal Binaries, the Developer 
Transition Kit, and all the new stuff Steve announced 
during his Keynote. Be looking for lots of great 
coverage of these exciting new developments and all 
the latest from Apple in the coming months. 


Enjoy!! 
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in this ulmronic age, the art of 
communicatian has become l)oih 
easier and more complicated. Is it 
any surprise ilial we prefer e-mtiil? 

If you have any questions, fee! free to 
call us at 805/494-9797 or fax us at 
805/494-9798. 

If you would like a subscripLion or 
nml customer service, feel free to 
contact MacTech Magazine Customer 
Service at 877-MACTECH 


We love to hear from you! 

Pka.se feel free to contact us with 
any suggestions or questions at 
any time. 

Write to letters@mactech.com 
or cditorial@mactech.com as 
apprxjpriatc. 
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If your rclaritMial database isn't a good match 
for your object-oriented development, you need 
a new database* 

Cache ^ the pon-rclational from 

InterSystenis, combines high-performance SQL 
for faster queries and an advanced object database 
for rapidly storing and accessing objects. With 
C.ache, no mapping is required between object 
and relational views of data, "fhat means huge 
savings in both development and processing time. 

Applications built on C]achc are massively 
scalable and lightning fast. They require little or 
no database administration. 

More than just a database system, CaclnJ 
incorporates a powerful Web application develop¬ 


ment environment that drajiuitieally reduces the 
time to build and modify applications. 

Cache is so reliable, it’s the world’s leading 
database in healthcare - and it powers enterprise 
applications in linancial services, government and 
many other sectors. With its high reliability, high 
performance and low maintenance. Cache delivers 
your vision of a better database. 

Wc arc InterSystems, a specialist in data man¬ 
agement tccluiologv' for over twenty-six years. 

Wc provide 24x7 support to four million users in 
88 ctHintrics. Cache is available for Wind{)vvs, 
OpenVMS, MAC OS X, Linux, and major UNIX 
plattbrms - and it is deployed on systems ranging 
from rwo to over 50,000 simultaneous users. 
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Make Applications Faster 
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GETTING STARTED * by Dave Mark 


Tiger. 

Automator 


Getting Started with 
Automator 

Automator h an appliculion Lhui 
ships with every ropy of Mac OS X K14, 
a,k*a. Tiger Contrary to pt>piiiar belief, 
Automator Ls not a ref>lacement for 
AppleScript. Aiitoraator is flora scripting 
environinenl. Rather Automator is a 
p<awerful sequencer tliat allows you lo 
sec|uence a series of commantls, called 
actions, to create a custom workflow. 

Still confused? No problem, 
build a couple of workflows and ytiull 
soon see the power of Automator. 

Stan by launcliing Automator. 
You 11 find it just where yt)u'd exjx^ci it, 
in your Appliaitions folder, higure 1 
shows the Auiomalor icon. 



Figure 1. The Automator icon. 

When you launch Atttomaroi; a 
new, untitled workflow window^ will 
appe^3^■ <see Figure 2), Hie wcaidlow 
window is divided into 5 main areas. 


1*he upi^er pan of the window is called the roo/bar. In the 
w'orkllow window show'n in Figure 2, the toolbar consists 
of tlie seardi field (on the left), anrl tlie tlimmed Run and 
Step buttons (on the right). 

Below' ilie search held is the lihairy, 'The library Ls a list 
of applications tlutt supjxirt Automator, as well as example 
and saved workflows. An application is said to support 
Automator l>y shipping with its own set of Ataoiiialor 
actions. lk>r example, in Figua" 2s liiimry, iTunes is 
selected, and the action list (just to the right of the library 
list) shows all the actions that shipped with iTunes. Etich 
time you re-launch il, Auioinator steps thrtiugh your list of 
iastalled applications and rebuilds its lilinuy and action lists. 


Want tn build your t>wn actions? Check out Ben 
Waldie's excellent Mac OS X Technology Guide to 
Auloniator. Ihe first lialf covets the details of using 
Automator The .seoind half tells you eveiytliing you need 
to know to rt>ll your own acaions, in ell i ter AppleScript or 
Ohjeciive-C. $14.95 for the eBcK>k, $29*95 for the prim 
Ixxik, Here’s the link: 

http://spidenAfCxks.com/books/automator 

If you’ve got an existing app and are even thinking 
alx)ut adding Autoimtor supjxirt now or in the future, the 
first thing you should do is nxtke your app scriptablc. 
Making your app scriptahle allows/enccxiniges otliers to 
WTite scripts and cieaie actions ihai incorporate your 
application into tlieir own workflows. Once jx:*oplc use 
ytmr app in an essential workflow, they are much less likely 
to switch to a competing prcxiuct. Briniani! 
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Q n last month’s column, we learned a bit about the bash shell, tlien 
played a bit with MySQL. I was originally planning on following that 
up in this month’s column with an intro to combining MySQL and PHP. 
But in between then and now, I ended up moving my baseline machines 
over to Tiger and, well, 1 ended up spending just a boatload of time playing 
with Tiger. So much so, that I decided to postpone my PHP MySQL column 
for a month so I could write about my favorite new toy, Automaton 


In addiikm lo llic toolbar, libraiy, and act ion areas, 
tile workflow window also features a workflnw area and 
a description area. As you'll see, tlie workflow is where 
all the work gets dune. We'il build a sample workflow 
next. In Figure 2, the workflow area says or ^idd 

actk>n*i here ro huikJ yatir worktlow. Tlie descri(>tion area 
coniains a descripuon of tlie currently selected action. In 
Figure 2, tlie description area describes the action Sian 
iTunes Phtymg. 



Figure 2. An untitled Automator workflow window. 

MACmCH 


Building a Workflow 

Nothing will connect the synapses In your brain 
more than acutally running Auioniator through its 
paces. ket*s build a workflow. Our first workflow 
will proinjit you to select a folder, compress the 
folder into a .zip archivei I hen create a new mail 
message and aiiach die archive to the message. 

In your w'orkflow window, click on Fmdcr in 
the Ubrary list. A list of all the cairrenlly available 
Finder actk)ns will appear in the Action list. Click 
and drag the action named Ask /or Finder/tons from 
tlic Action list into the wnrkfkiw area (see Figure 3)- 



Figure 5. Adding the Ask for Finder Items action to 
the workflow. 


As you can see in Figure 3^ the Ask lor Finder 
Items action is represented by a subpane in the 
workflow area, Eacli action comes with its c>wn user 
interface and an appropriate description in the 
description area (lower left area of die window). 
Ecich action is numbered. As you can see in the 
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iipper-lert corner of this action^ the actk>n is numlxrr 1 in 
our workflc^w set|iience. 

Since we want our at:tion to prompt for a folder, 
select f'o/r/ers from the Ty'jx^: popup mcMiu. I selected 
Desktop from the St^rt at: popup so the Finder would start 
prompting me at llie desktop. T changed my prompt to say 
Choose a Foldei': and I left Uic Allow Mukiple Selection 
checkbox unchecked. 

To test this workflow^ click on the Run button on die 
right side of the toolbar (tup of window). A panel will 
appear, prompting you to choose a folder (see Figure 4). 
Maneuver your way to a folder you like, then click the 
CiToose button. Note that you are only allowed to select a 
folder, not a File, and that multiple selections are not 
allowed. Just as you specified When you click the Chcxise 
button, the workflow stops. 



Figure 4 This panel appears when you 
first run your workflow* 

Not very exciting, but it does wliai it was supposed 
to. U prompted me fora fblden Since Ask forF jVic/ct/ fc/ns 
is our only action, once we ciicked Cixx^se or Cancel the 
workflow exits. Sure would l>e nice to be able to get a bit 
of feedback, make sure things are running prt)|jerly. One 
way to do this is to open the log window. Select Show Log 
from the View menu. Figure 5 sIkjws my log window after 
1 ran my workflow. Note that the log windcjw is exlensilile 
(drag die liide dot at the bottom of the window) and diat 
it is wiped at the lx*ginntng of each am session. 

. OlfillW 

1 



would be. nice to get some feedlrack that Automaior got 
the right folder. Autnmator provides an action, called 
V^ew Results, diat gives a bit of detail on the values 
returned by the previous aciion. 

Click on die Automator entry in the library list, llien 
drag die \^cw Results action to the Ixatom of your 
workflow'. Click the Run liLitton. When prompted, select 
a folder and click ilie CJioose button. Notice that the View' 
Results aciion displays (see Figure 6) an AppleScript- 
looking result tliat rcflecLs die folder you chti.se. You can 
select this text and copy it to the cliplxiard, if you ever 
find die need. 



Sian ai: tSm Pesfcta(> l *) 


PriMnpt: Ohkhc a Folder; 

Q Atkiw Muitipl^e SeiKtIon 


Resulii 

j {aiisK^I^InlQihH^UHrKctavamarlc^leskt^ films:*} 


f4fvrftid4't 


Figure 6. Adding the View Results action. 

Take a closer l<K)k al the area, aUnit 2/3 of die w^ay 
atmss die action (from left lo right), where the two 
actions actually connect. Figure 7 focuses in on Uiis area. 
Tills area shows the type of data lieiiig passed along by 
the top acik>n and expected by the bottom action. Notice 
that they match. Botli actions are dealing w'ith the same 
data type. As king as the types match, the data will get 
passed as expected and everything will end up just 
peachy-keen. If you pick an action tliai expects a 
different data type than you are passing, Autoniator will 
Hag this by displaying the types in red and liarking 
furiously (well, OK, not dial last part). Tliere will be times 
when you don't care about type mismatches (for 
cxatiiple, if you are just ignoring the input) but that 
glaring red warning sign is really nice to have. 


fi!GS/Fold€rs 


Files/Folders 


Figure 7. The Interface between two actions. 




Figure 5. Automatons log window* 

The log w'indow is useful in tracking your progress, 
but it doesn’t really show' the result. In this example, it 


Let's finish off our workflow'. In the library list, click 
on Finder. In the aciion list, drag ihe action Create 
Archive into the middle of your workflow, l>elovv Ask for 
Finder Items but above View Results. Note that Automator 
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automaticalty runuml)cr*s your actions so Crculv Asduvv 
lH!comc\s numl>cT two. 

Fixture 8 sht>ws my version of the Creafe Archive' 
action. Notice that this action features an Op£K>ns 
disclosure triangle, whicli Fve o|^ened. Not all actions have 
O/X/oiis; Worth looking for it, though* Ihe Show Action 
When Run checklxjx lets you ciistomize the at:Uon's user 
inierf'at:e, fiaving the actif)n prompt you for some or all of 
the sellings instead of using tlie settings you specify. 



If y<Hi run the action again, you'll l>c pronipted to 
choose a folder atid that folder*s conients will be saved as 
a Clip archive* 

Let's add one last action. In the library, select Ma//* In 
the Mail aciion list, select New Muil Mc5.rdgc. Drag it belt>w 


Cretite Archive and above V7ew Results. Figure 9 shows 
my version of this action* Not ice the opt tons available to 
you* Run die workflow* You’l! \yc prompted for a folder, 
tlie folder contents will l>e archived, a new email message 
will be created with the specified sellings and the archive 
will lx* attached to the message* Qk> 1 l>eans! Now youxe 
getting a real sense of the power of Automator. 1 totally 
love this app. Nicely done, Apple, 



Figure 9. The New Mall Message action. 
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Take a Bow» BBEdit 

One Thing yoiill noiice as yon kx^k through the library 
list, is th^l nestled in among all the Apple applications that 
feature their own actions is our old l>uddy BBEdit. By ihc 
time you read this, there aie sure to be other apps that 
ship with their own actions, but BBEdit was the first third 
parly a[>plicalion to ship w'ith Auioinator in mind. Figure 
10 shows a list of the BBEdit actions. 


Note that you1l need to have BBEdit 8.2 or later installed 
in order for the BBEdit actions to show up in Autoinator. 
Don’t have BBEdit? Download the demo from 
lutp://l)l>edii.com. It doesn't sock! 



Y Appticaiions 

^ Add Line Numbers 

^ Address Book | 

Add Prefix 

Automator 1 

^ Add Suffix 

1 

^ Change Case 

0 DVD Player 

^ Coficalenatc 

Finder | 

^ Convert Spaces to... 

^ Font Book 

^ Convert Tabs to S... 

iCal 

^ Convert to ASCI! 

IDVO 

% Delete Lines Com,.. 

^ Image Capture 

^ Educate Quotes 

(Photo 

; Extract Lines Com... 

^ ITunes 

X Filter BBEdit Items 

>J| Mai) 

X Hnd BBEdit items 

PDF 

’s* 

^ Get Contents of e,„ 

^ Preview 

^ New BBEdit Docu... 

Q QuickTime Player 

^ Normalize Line Br... 

@ Safari 

^ Open Files in BBEdit 

^ Spotlight 

^ Remove Duplicate 

X System 

^ Remove Line Num.,, 

‘7 TextEdit 

^ Remove Prefix 

^ Xcode 

Remove Suffix 

|h ^ Example Workflows 

Search and Replace 

► ^ My Workflows | 

^ Set Contents of BB.,. 


^ Sort Lines 


Straighten Quotes 

-i 

t0i Zap Gremlins 


Figure 10. The BBEdit actions. 


One Final Example 

1 know this column is running a bit long, but I just 
can’t help myself. Gotta do t>ne more example. 1 think 
this one is very cool. 

Start by launching iCal. In the CV/iendar menu, select 
Subscrihet..., then enter Bits URL: 

webcal:/yicaL mac com/ica I/DVDs Jes 


Now click the Sul)scni>c huilon. Your calendar should 
be populated with a new, weekly item called 
Releases. Wouldn’t it ]>e cool if you could access that info 
in BBEdit? Mayl>e use BBRdit’s actions to format the list in 
some cool way, then send the list as an email to your 
DVD-swapping [buddies? Well, Em not going to do all that 
work for you, hut I w'ill get you starred. 

In Autornaior, close any open workfli)ws, then creale 
a new, untitled workflow by selecting Afcw from the File 
menu. 

In the lilrrary list, click on iCaL Drag the action Find 
iCai Items to the workflow area. From the Find: popuf:> 
menu, select Fvents. Notice that the aaion name changed 
to Find Events in iCai Now make the Whose: sequence of 
l^opups read Calendar, then Is, llicn DVD Rdcascs. 

Now^ dmg another iCal item, Event S’t^mnL'ny, into the 
workflow, below the first action. In the For: popup meiivi, 
select This Wex^k. 

Finally, click on BBEdit in tlie lil:jmry list, then drag 
the action New BBEdit fkK'ument to the end of your 
workflow. Figure 11 shows my final workflow. 



Go ahead and run the w'orktlow. Note that the EVenf 
.Synnnary action can lake a w'hile to cook through all die 
new DVDs. Figure 12 shows the BBEdit windc^w that 
appeared when I ran my workflow'. Note that I have my 
FiREdii prefs set to soft-wrap at 80 columns. 
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Figure 12. The new releases in a BBEdit window. 


Until Next Month... 

There \s jusi so inuch you am dt> with Auloniator. 
Your assignment, shouki you choc^se to accept it, is to 
clean up the DVD listings. You!ll want to take a look ai 
the HHRlfi acrions Conauvmli:, Scrtn h anc/ Rvpkicc (use 


grep), De/ere Lmes Coni^umng, and Sort Lines. Of course, 
there are any numiier of ways to skin this cat. 

Want to learn more about Automalor? I already mentioned 
Ben Waldie’s book (http://spiderworks.com/books/automator^^ 
Here’s a pair of web .site.s dedic^ated to Aiitomatfir: 

http://automator.us 

http://www.automatorworldxoni 

These sites are both well worth the visit. Lots of great 
examples, downloads, and other- great resources. Enjoy, and see 
you next month! © 


Yill 



About The Author 

Dave Mark is a long-time Mat developer and aalhor 
and has written n number ol books on Macintosh 
development. Dave has been wrDing for MatTedi 
since its birth! Be sure to check out the new leant C 
OB the Matiaiosh, Mac OS X Nitwa at 
http://www.spiderworks.(om. 
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WBb design - beyond 216 c i rs 
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New software ghres dosquors a 
now way to look at eolor 


Thinking Outside the 
216-Color Box 

Lets ulk a little dK)ul how we 
selea colors in 2CX)5, Consider tliis: 

• Tile average human eye can see 
alxHit 3,000,000 colors 

• 72% of monitors today display 
millions of colors (24-32 bit) 

• 25% of monitors today display 
tliousands of colors Cl6 bit) 

'llien why do Web designers lend to 
keep within the old 216 “Web-safe” color 
fKilette? I rL'alize tliai you don't anymtjre 
hut Tm talking alx>ut the otlier guy. 

First a quick history lesson for the 
youngsters. Rack in the old cbtys, we 
l>ei'mne awate tliat certain cok:»rs we 
picked on our Macintosh PowerPC didnl 
ltx>k right on the client’s Windows 3d 
tnacliine. Some kx^ked all mushy ;ind on 
close inspeclion, they were not even a 
st>lid <t>lor but were a collection of 
difTcreni colored pixels - tliey' were 
“dithered 7 Due to this facT of ct:)mputer 
hardware life, we cjuickly adopted a set of 
colors that would not dither between an 
8-I)it (256 a>lons) Mac and PC. We ended 
up witli a fme palette of 2l6 colors. 

So iPs 2005 and if you ever take a 
Lour on the Imemei to explore articles, 
discussions or software regarding color 
for the Web. this same 2t6 palette is still 
with us. We seem lt> embrace the latest 
server-side technology, the newest tool 
to make our sites cool and functional, 
but we still iia it in 2t6 (‘olors. 

OK, I know not everyone stays 
with the old Welvsafe palette and all 
you Flash people are exempt, bur Icl 
like to discuss that as we move outside 
into the light of thousands or millions of 
colors, there is a new tool to help us 
ltK>k at coli>r in a new way. 

Master Colors HVC 
Color Composer 


By Dean Wilcox 


Even tlrougli we always say it's our 
skill alone rliat makes us so good in our 
client’s c 7 es, every once in a while a new 
graphics tcx>l comes along tltat can make 
you a !K*tter designer. 'The HVC Color 
Cr)mposer^^ from Master Colors™ is just 
such a Ux>l, In fact, diis Pliotoshop 



















Color Quantification Technology 


plugin for Mat^ can tnake yoti ]<K)k like a genius to your clients., 
or ai leasi gotxl enough to get pLikl on time. Considering the fact 
tliat this st)ftwaiie lias the potential to make eveiy design 
professional a master of color compcxsition, its $129.95 price rag is 
actually cjuile a baigain. 

Master Colors adds a filrh txilor space to the l^hotoshtjp color 
[licker to create a (x>lor space tliat actually makes sense, 'the 
in ihe prcxJuet name stands for hue, vxilue and chroni;t 
(intensity). To get aecx^ss to the uniqiie HVC color space is worth 
the price of this sottwiire alone. All the otlier color sfxices are still 
available on the PhoLosliop Cailor Picker, but the I JVC itKxiel is the 
most LLser friendly and the one that makes the most iniuiiive sense. 


We all know there is an underlying matheinatical 
coherencre in music (and many software writers are also 
[iiusicians). Although musicians do not have to think alxmi 
math when they pertVirtn, matlvtanatical orderliness plays a 
crucial role in their ability to control their medium. Hssentially, 
Master Colors has brought tJiis siime order to the list? and 
manipulation of color. 

Master Colors is a pioneer in color quantification 
tetrlmology. Simply put, this is a method whereby numerical 
distance between all colors can be measureil by contrast. (See 
i'ig. 3)^ Contrast is the line that gets created when two colors are 
placeti next lo each other. Tlte stifter the line, the lower the 
nuinl>er, the shaqxr the contmsi, of course, the higher the 
numlier. Ihe HVC Color Composer not only determines just the 
contra.si Ix?tween values, which is the way a lot of us think 
about contrast, but the combined contrast of hue, value and 
chroma. This is not a simple exercLse in desaturating colors and 
then just measuring the resulting values. 

Unear B&W Contrast HVC Color Contrast 




Only W«|J cotffff 


Fig I. Master Colors Color Composer color picker for 
Photoshop. Showing new color space controls: hue, value 
and chroma. 


Fig 3, Visual diagram of how we typically view "contrast" 
Linear black and white ts what we're all familiar with. Color 
diagram visualizes the concept of contrast between colors. 


what's interesting alxiut the new coltir dialng lx>x is the 
visual representations of thr? color .spac:es. As you dick on tlie 
various radio buLLons, H (Hue), V (Value) or C (Chroma), you see 
new visualizations of tile colors and their relationships Lts olJicr 
cok)rs. Clicking the 11 radio bullon, yt)u view the HVC space by 
hue slk'es and can navigate the hue axis with the veilicul slider, 
exactly the same in the ba.sic Photoshop color picker. 'Hie shape 
of the visualization dianges upon the amount of chroma in any 
particular cokir. By clicking the V radio button, you view HVC by 
value slk!es. Value is a color lightness property; with thb we view 
all coloi's of a ceitain lightness at once 'fhe visuaiizafton is similar 
to hue, hut now you .see all tif the other colors and their relative 
chroma value. With the C radio button selectcxi, you view all 
colors of a cenatn inieasitx^ at once. In Fig 2. the small dot 
represents the Kime color {blue) within each cxikir space. 


Just as in music, once the numerical relationships between 
colors can be established, an orderly system of hannonics can be 
<Teated, T\m is exaedy what Master Colors has done. But enough 
witli color contrast theory for now, we’re designers aftcT all. 

dhe great thing that ihe Color Composer does is to create 
tiser-defined palettes based upon colors you select, lliey can 
saved (as swatdi aco file) and then loaded into itie Swatches 
window. Select a color, or mnliiplc colors with the Color 
Composer, the st>ftware crunches the numixns and opens up an 
iniuiiive and aesthetic process for color seletiion from die 
dynainic palettes the software generates. These are iK)t static 
palettes. 'Hiese are palettes created by the software at the 
rtXjuesL of die designer to work specifically with their own color 
choices, Tliey are absolutely unit|ue. And diey are way beyond 
216 regimented colors. 


Putting the Technology to Work 


Fig 2. Visual representation of color space. First example 
is your typical HSB, second through fourth demonstrating 
hue, value and chroma. 


For lilt rest of tlic articlt;, we'll take you ihroiigh the 
process of using the liVC Color Omiposer Prt)fessional™ to 
create color combinations for a Weir site for a fictitious textiles 
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i}yvh finu, TIil* eulor oimposititins created were cx)mpliaited 
enoLigli that there Is no way dic 7 amid have been created 
without this software product. Well. OK they could have, l>ut 
only if you were a .siiKlem in color theory, had plenty of time, 
patience. Mountain IX‘W and not lo meniion an amazing .skiD at 
selecting just the fight colors. These composilitrns were ' 
cxtraordinadly easy to create using the Color Conrposer. 

Granted, as witli any loof it’s still up to the designer to 
make a series of intuitive color choices from ilic palcUcs. If you 
insist upon a coinposiiion of purple, orange, pink and grecai. 
there’s no helping you (BTW I don’t want any emails if you 
actually have used those colors together). Bui the s<jfiw'are 
instanlly creates hnrmonicaUy coherent palettes that work with 
certain target colors as a design progresses. 

For our little demonstraiiori, we liavc a new diem that 
specializes in organic and earth-friencUy dyes for the textile 
industry. Mr. NewCornpany Chow original) has stated how his 
new dyes are .so unique dial die view'cr must lie able to see all 
the wonderful colors they can produce. Obviously liis target 
audience is not the 1 in 12 folks wlio have some .sort of color 
deficiency and have at die minimum a Ifi liit monitor. Plus w'e d 
I never get the results we need with just 2l6 cokiFs. We'll sian with 
a cjuilidike diamond and square pattern and see how using the 
Color Comjioser produces many succes.sfiii color combinations. 
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Your Ono stop Solution 
for Custom Toxtilo Dyes 



Fig 4. Client wants see various color combinations. Our 
scenario will utilize the Auto Range palette using the 
white background as the target color. 


The Amazing Auto Range Function 


mm:c 


colors may Ikj to work wiih, the IToptirrion function instantly 
generates hundreds of colors that will work wilh the original rwx> 
colors imposed on you by your client. 

Tfic Range functit>n give,s the designer control of specific 
contrast numbers, so you can create your own harmonic 
progres-sions. ITie Mange function is important for complicated 
color relationships vvliere three or more colors are toucliing. 
lliis is somewhat of an advanced user function, which we 
w^on't get into detail in this article. However, there Ls an 
excellent online manual you can download from Master 
Colors' Web site that goes into advanced user hmetions in 
some detail. 

The Auto Range function creates a simple proportional 
collection of contrast numbers in a doubling progression, btit 
the Iieauty of Auto Range is the designer dtiesnl have to think 
about the harmonic technicalities. Instead, you simply get 
these great palettes where every c'olor has a malhematicaliy 
coherent relationship to die while background we decided to 
work with. 


Tlie soflwam offers three functions for buikling color 
palettes, the Proptinion buUon, the Range bmton and the Auto 
Riinge btitron. 

The Proportion function creates a palette of colors that Lire 
a certain profXJrtional distance from any two colors, such as 1:1, 
1:2, 1:3, etc. This is incredibly useful lor .such tasks as finding 
one or two colors that work well with let's say tw'o logo colors 
a client gives you lo work with. No matter how difficult these 
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Fig 5. Auto Range palette shows colors with a contrast 
range of 5,10,20 and 40 contrast steps from white. 






Starting witli our w^liite backgrountl, we ll create a palette 
I with the Auto Range functUm. Thi.s jrroduces a colleeiion of 
colors with pre-xleterminecl contrast levels of S, 10, 20 and 40. 
Next, well save the palette, replace our original palette in the 
Swatches w^indow and start filling in the diamond and square 
pailern. For our first example well restrict our.selves u> colors 
solely in one contrast range. 
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color comliinalions l(x>k with the full compliment of till contrast 
ranges 5 to 40, Well also explore some other compositions 
using a few slight mcxiificaiions to our original palette. 


Your One-slop Solufion 
lor Cuslom lexlilo Dyes 


Fig 6. In Photoshop, replacing swatches with new palette 
representing color contrasts 5,10, 20 and 40. 


Fig 9. Resulting color composition from a palette with full 
contrast range of 5,10, 20 and 40. 


Your One-stop Solution 
lor Cuslom Textile Dyes 


Fig 7. Selecting colors within the S contrast range. 


Nfiwcompany 


Fig 10. Resulting color composition from a slightly modified 
palette. In this case using black as the target color. 


Your One slop Solution 
tot Custom lexlile Dyes 


rJ ^''OTnpany 


Your One-Stop Soluton 
tor Custom Textile Dyes 


Fig 8. Resulting color composition from the saved palette. 


All of the colors wiihiii lliis range of 5 work very well 
together, even if they are very light, And it didn't take any 
rime at all. In fact all of the color compo.sition.s done for this 
article were done in short order. 

But remember, Mr, NewConipany wants to see lots and lots 
of color combinations. So next well demonstrate how other 


Fig 11. Mix 'n Match. There's no limit to the combinations 
that can be created. 
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Moving Forward 

Within a short amount of time weVe been able to create 
various color coinhinaiions for review by Mr. NewCornpany. 
It's pretty amazing when creating these complicated color 
compositions with dozens of relationships to know exactly 
wliat each color is doing in the composition from a 
harmonic point of view, and to finally have total and 
absolute control of your color design. When the client ask 
you how you came up with so many great combinations, 
you fust smile and remind him that's why you Ye getting the 
big-bucks (youYe supposed to chuckle at this point). 

These examples were created from jusi a few palettes 
using the Auto Range function. You can imagine if we used 
the other functions, Range and Proportion, the more 
combinations we could have arrived at. And did I mention 
it's incredibly easy to use? 

So, your client loves the work, you Ye a hero, lie just 
can't decide upon one combination and decides he wants to 
use all of them. Wc'II deal with that some other day. 1 realize 
it’s not every day we have to deal with situations as weVe 
described, many times we don't have the luxury of selecting 
dozens of colors. Added to the fact thal from usabiliiy and 
accessibility tK)inLs of view, certain color combinations arc to 
be avoided. But that's also w^here this software can help in 
quickly exploring and discovering good color combinations 
no mailer what the restraints. 

Nevertheless, once you get your head around the 
concept of hue, value, chroma and color contrast and start 


creating your own palcLtes with the HVC Color Composer, 
your re!alionslii]> with the Photoshop color picker will be 
irrevocably changed. Between the new visual relationships of 
the cf jlor spac:es to paletLc creation, it's another great tool for 
your tool belt. Use it enough and you won't be able to live 
without it. In fact, I would have to recommend that anyone 
who works with color professionally should really have this 
prfKJuct. Tile results arc fast and extremely impressive. Best 
of all, the process one goes through to get the.se results is 
remarkably intuitive. In a matter of minutes, just about 
anyone can be prollc ienl with this amazing new product. 

To purchase the IIVC Color Composer, to download the 
on-line tutorial or to simply get a more comprehensive 
explanation of how lo become a master of the new HVC 
color universe visit the Master Colors Web site at 
www.mascer-colors.com You can also submit queries to the 
Master Colors staff at, quesTions@master-colors.com. Happy color 
picking. 

_ 

About The Author 

Having spent 25 years as a graphk designer and the hst ten in Web design, 
Dean WSrax has worked on projects for some of the world's most recogniied 
companies. H/lost of his professional life was spent at landor Associates in 
New York and San francisco and now has bis own modest practice in Sausahto. 
He can be reached at dean@wilcoxdesigttsxam. 



Download yotir free demo and temptate and discover the 
power of Master Colors HVC Color Composer Pro today 
Go to www.master-colors.com/downloadsAemplates 


• Graphic Designers Digital Pre-press 

‘ Photographers - Textile Design 

• Art Directors - Color Specifiers 




Create your Color Compositioos io 

Perfect Harmony 


Harmonia Color Coheronoe 

Master Colors^ HVC Color Composer™ etilhes color quantification 
technology to instantly organize mathematically coherent color palettes. 
The software autamatically does the math and creates beautiful powerful 
color combinations to use in a natural and intuitive way. 


Target Colors 

Start with one or more colors and the HVC Color Composer instantaneously 
generates palettes for use with your selected colors. 



The absolute must have plug-in for creative 
professional Photoshop users! 


Available online at www.fnaster*colars.ooni 
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THE SOURCE HOUND • by Dean Shavit 


Ghost In 
The Machine 


Mea Culpa 

First, l)oft)rc 1 go any i'unhcr, 1 liavc U) 
say the following: 1 am a liar. In last 
montlVs Source Hound, 1 promised to bring 
MacTech readers an investigation into Tiger 
Server's new extended [ijcnnissions a.k.a. 
Access Control Lists. Wliile 1 am sttre that 1 
could have 'foitten into the topic'’ with the 
Soiirte Hound's special flair, it appears that 
Ed Marzcak, my fellow ccjliimnist, liad an 
ace up his sleeve, so he'll be covering Tiger 
Server's ACLs. 

One of Us, One of Us 

If youVe ever worked in coux^rate IT, 
the verb “Ghost” (as in 'to Gho.sr’) is sure to 
conjure up an image familiar to many, that 
of a Help Desk Analyst, floppy disk in hand, 
with a big smile on ilieir face: “So, your PC 
giving you a bit of the 'ol trouble no, well , 
go have yourself a cu(> of coffee and when 
you come back, it’ll all be right as rain.” One 
reboot later, a few keystrokes, and the 
Windows PC is back to pristine condition, 
barring no hardware trouble. It's magic. 

Cloning liard drives has been the 
standard in corpoiate PC support and 
rollouts since Uic mid 1990s. It’s a great 
way to cut the installation times for the 
Windows Operating System and 
applications down to minutes in some 
cases, rather than hours. Network home 


directories or Toaming” prtifiles, where the users’ data resides 
on a server, railier than tlie local workstation, makes cloning 
almost stancHrd operating procedure for fixing even the smallest 
of software glitches. While the '"Imagisis” are often thought of as 
a scIkk)! of nuxlern ptxrls, whose ranks included William Carltjs 
Williams and y.S. Eliot, today Tmagists” are a highly-skilled 
kKisely-knit grtnip of tradesmen (ami women) who spend their 
days managing a single image—ofx:raLing system and software 
{.sometimes referred to as a “standard image") dial gets deployed 
onto dozens, hundred.s, or even thousands of similar PCs. 

The verb “Ghost" comes from die same type of lexica] twist 
as calling eveiy variety of Cola a “Coke," Symantec, the maker 
of antivirus and disk utilities for the Macintosh purchased the 
Ghost hard disk imaging .solution from Binary Re.search Limited 
in June of 199B. As a defacto standard in the IT world, Ghost 
was and .still is the preferred cloning .solution for Windows PCs, 
At the time, 1 remember more than one person inquiring as to 
why Symantec didn't ship a Mac version of Gho.st, since 
Symantec was a company that heavily supported the Mac with 
Symantec Anti-Virus (now Norton Anti-Virus) and the 
indispensable Norton Utilities suite of disk tcxjls. The standard 
answer to that question was “with the Mac OS, you don't need 
TO done systems, as you can simply drag and drop a System 
Folder from the network or even pre-installed applications.” 
That indeed was true. At die time, all you really needed to done 
a Mac OS system and all applications was a SCSI hard drive big 
enough to hold everything. 

In My Image 

Working with images of floppy disks was nothing new to 
the Mac OS, even in the late 1990s. Until System BT, for 
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he mind is not a non-physical substance residing in the body, ‘a 
ghost in a machine,’ but a set of capacities and abilities belonging 
to the body.” 


Gilbert Ryle, Concept of Mind (1949) 



exatiiplt% Apple's installer letlinology used .sell’-iiKJii ruing disk 
iimges on the tiffliantl chance sonieone would actually need to 
produce ilie nineteen floppy disks to install System 7.5.3 on. let’s 
say, a PowerOook 5300 without a CD-KOM drive. Utilities such 
as DAIi*r (Disk Archiving Ttx)l) and Disk Copy became more 
exunmonplace as iastallers grew larger and larger as Apple 
maintained compatibility Ix'tween Macs with floppy drives and 
those with CD-liOMs. 

Hventually, Apple did away with the floppy drive altogether, 
Lind now, with the retail release of OS X 10,4 Tiger shipping only 
on DVD-ROM, Apple is trying to dcj away wiili the CD-ROM as 
installer media as well. Tliis is a pattern tliat repeats itself every 
lime a type of media becomes unwieldy. It was not uncommon, 
for example, that an iMac or PowerMac Gi shipping in 2001 
with OS 9.2.2 and OS X 10.1 would have a set of six or more 
resioa* CDs included Running the software resttjre sexjuence 
would put the computer back into factory condition with all 
bundled software intiiided. For tluxse of us who were curious 
afx)Ut ihe restore process, a little investigating led u.s to tliscover 
a nifty program called ASK (Apple Software Restore) hidden 
away on the first restore CD. 




Disk Copy 

ASR 


Figure K Classic Mac OS Disk Copy and ASR, Circa 2001 

Tliose of us who played with the Classic Mac OS version of 
ASR found it could cki some intert!sting things for deploying many 
Macs at the same time. In late 2(X)1,1 used ASR to roll out 35 iMacs 
at a cuslomcPs site in a single day. 1 prepped a single iMac and 


testeti it for a while, made tweaks and updates until 
everyone agreed diat it was ready, then used ASR to clone 
it to the rest of the Mac's using Firewire Taiget Disk nitjdc. 

The Ghost Reappeareth 

Prior to the release of OS X 10.2, ASR fvlJ) was 
Livailable only upon Especial axiiuest" from an Apple System 
Engineer or an AppleCare representative. This first and 
unsupj)orted version of A.SR had a preliy short lile span, 
because by the Lime August of 2002 liad rolled around, 
Apple released OS X 10.2, along with a spiffy' new version 
of Disk Copy and ASR as a supported cormrianddine tool 
(Disk Copy was later rolled into Disk Utility w'ith OS X 10,3). 

It was alx^ut this time that I re-discovered ASK as a 
useful tool for cloning Macs, mtxsily out of need for 
refreshing our ten training Macs at our office. At first, fd 
set up Net Install {which, by the way, deserves another 
look iti Tiger Server) but had found it slow and awkward, 
even thougli 1 was able to automate the installation of OS 
X and several applications. ASR, it turned out, was exactly 
what I needed. 

Like Peanut Butter 
and (Chocolate 

By itself, ASR is the '“Peanut Butter” of the cloning 
process, and without disk images, the ‘'chocolate,’* is only 
really useful for making a quick down-and-dhty copy of a 
hard disk, as Pd done hack in 2001 with the 35 iMacs. Bui 
thi.s is still a great thing. Let’s take the retail Tiger Install 
DVD, for ejcample. If you have a numlx;r of Macs wiUiout 
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ihc al>iiity ic> read a DVD drive, your only alternative is to order 
the $19.95 CD media exchange kit directly from Apple, ITiis is 
hardly convenient. Not only that, you'll still have to swap out 
thrtx; or four CDs during the installation. 

'Fite solution to this dilemma’s rather simple. You1l need to 
insert tlie Mac OS X Tiger install DVD into a c'omputer, and 
attach a Firewire hard drive, making sure to uncheck the "Ignore 
Ownersliip on This Volume” checkbox In the "Get Info” window 
of the disk. If you don't want to use up all of the space on tlie 
Firewire drive, you might want to partition it Ixrforchand, selling 
aside 4.2 gigs for the installation files. Insert tlie lastallation 
DVD, attach the Firewire Drive, and issue the following 
command in the Terminal: 

ciassadniin:^ claesadminS sudo a;ir -source /Volumos/MacV 0S\ 

X\ lDStall\ DVD/ -target /Volmjiefi/Firewire/ erase 
Password: 

Validating target.done 
Validaiing aource♦..done 

Erase contents of /dev/disk2sl0 (/Volnates/Pirewire) ? 

[nyh y 

Erasing target device /dev/disk2sl0...done 

Validating sizes...done 

Restoring 

.,.. 10 ,.,. 20 ..,. 30 .... 40 ,. 60 ..,. 70 .,.. 80 .... 90 .... 100 
Recount 1 ng targei volnine...done 
claesadiinj"' classadai±n$ 

Note the presence of the -erase flag in the ASR command. 
4'his is very important. Wiilioui the -erase flag, ASR will perform 
a file copy mther than a block copy, wliidi will copy items *4n 
f>lace,” (jverwriting folders that exist witli folders of the same 
name from the install source, yet leaving in place any other 
extiint folders. Not only can this [potentially lx: me.ssy, it cMn also 
lx: disastrous if you accidentally niiscalculaie wltat's going Co i>e 
iiisialled or think that someliow the source and destinalicio will 
^'meige." Possible data loss aside, ihe file copy or “re,store in 
place” is going to be much slower liian the fast bkK k-level copy 
that the -erase flag enables. Using the bliKk<’opy, tile whole 
process takes exactly nine minutes. Now, you can boot off of the 
Firewire disk by holding down the option key at txxa lime or 
scHcciing it rn the .Staitiip Disk System Preference (double^ 
clicking the bbek "Install OS X” icon in the Finder won't work) 
and run that upgrade installation or archive-and-insiall or nuke- 
and-pave (erase and install) right from that same Firewire drive 
at an iaslallalion speed I hat’ll average less than ten mimiies. If 
you've got a lot of inslaNations lo do, and dotft want to use a 
suindard image, using a Firewire drive instead oftlic DVD drive 
is a real limesaver 

Hey Tiger, Your 
Ectoplasm is Showing! 

One of the new' '"features” of Tiger is a efiange in the way 
the Finder liandles invisible files. Many of us veteran doners 
liave nolic'cd ihai the “.hidden’* file that lived at the root of the 
startup disk in previtjus version of OSX, has been sloughed off 
in favor of “genuine Mac OS 9 style” invi.si[>iliiy Dags. While the 
“.hidden" file was a pretty elegant solution, allowing Mac admins 
to specify additional invisible folders such as /sw for F'ink 


(http:/ffink,sourceforge.net) iastallations. Wliat Is ratlier inelegant, 
and at first glance pretty sptK)ky, is what happens a/ter OS X 
10.4 is cloned—die fonnerly invisible links to /etc, /v-ar, /tmp, 
and the /Volumes directory {and perhaps all of the rest, iis in 
die figure Iil“Iow) become visihh. 'lb fix this, a doner either 
needs to recreate tlie .hidden file (which is stiN respected by 
OS X 10.4) with the tmp, var, etc and Volumes entries, of course 
making sure to set the proper permissions w'hen finished, or 
follow Apple’s instructions, which requires having the Mac OS 
X Installation DVD inserted: 



Figure 2. Ectoplasm On 
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Figure 3. Ectoplasm Off 


Using a .hidden file: 

\iiiacg4:/ Qiostadi]]in$ sudo vi .hidden 

Password: 

etc 

vat 

ttap 

Volumes 

l]nacg4:/ sudo chmod 444 .hidden 


Apph's Dirtxiians fn)w Ksmwltxlge nrtide nun^x^r ^i0l67: 


claEsadminsr"* classadmiti$ cd / Volumes / Mac \ 0S\ X\ InstallV 
DVD/System/Installation/Packages/OS Inst all jnpkg/Gcjntonts/Resou 
zees/ 

clafisaiimiPGt /VoluHaea/Mac GS X Install 

OVD/Systcm/Tiista! latlon/Packages/OSrnstall^inpkg/Contents/ReBou 
tees classadi«in$ SUflo ./SetHldden /VoliiMes/Mac\ 0S\ X\ 
Install DVD\ 1/ hidden„NacOS9 
Password; 


aet Itivialble: 
set invisible: 
set invisible: 
set Invisible; 
set invisible: 
set Invisible: 
set invisible: 
set invisible: 
set invisible: 
set invisible: 
set invisible: 
set invisible: 
set invisible; 
set invisible: 
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Whew! That’s a lot of typing to stuff that Ectoplasm back into 
the ghastly areii of the OS, as it should lx?. However, don't rry 
running this command on the ainrenl .startup disk Ixfore making 
your image! Can you say instant kernel (yanie? 1 can! Evidently 
Apple engineers haven't yet tbund a way to incorfX)rale the 
“hidden_iViac<3S9'’ attributes into the imaging process, wiiich 
brings us to the our next [XJtni: exactly what is the proper process 
to prepare a cione-able disk image for use for figer? 

Ghosts of Images Past, Present, 
and Future 

Up until the release of Tiger, die answer to that question 
was very siniighlibrward: use Mike Boniliich's amazing Quixm 
Copy doner (http://www.bonibit'h.com), wbich c’ould autt>inaLe 
several steps of the imaging prexess, and which is also, by tlie 
way, coasiderecl by nuiny (myself included) to be one of the 
greatest AppleScript Studio Applications in existence. Carixrn 
Copy Cloner also alleviated the need to lxx)t off of another drive 
to make the disk image, .saving st)me lime in that regard. 
However, due to some drastic clxmges to the way AppleScript 
Studio handles autheniicalion in Tiger, as well as some Tiger- 
.specific imaging issues, such as the yiicky ectoplasm above, 
Carlx)n Copy Cloner no longer works, although you can run it 
from a Mac Ixxxed from OS X 10.3 to clone a drive wiffi 10,4 on 
it. Though liombich is working on an update to CCC for Tiger, 
whidi well hopefully see soon, it's also useful to step through 
the proces.s of creating an image lusing Apple’s Disk Utility. 

Step 1: Preparing to Make an Image 

In last Month's Mac'Jech, Clay Williams' excellent article 
^An Introduaion to Builds, Creating Them and Using Them in 
Mat' OS X" gave an overview of the proc^ess of CTeating an image 
for a deployment. While we're not going to concentrate on llte 
nuances of building the “perfecC image here (which is an art 
form unto itself), let's just say that there's certain '‘gotchas" to 
look out for prior to cloning multiple Macs. 

1. Make sure ntjnc of the applications on your image require 
individual serial numbers, Often these will chet'k the 
network and wiD simply ctjmplain and cjuii if riicy detect 
other copies of tliemsclvcs running. 

2. Make sure you build your image on the newest, fastest Mac' 
you can get your hancls on. Itll make the imaging process 
snappier, as well as ensure that all of the proper driver-level 
support is in place for newer hardware, as well as the old. 

3. Create your users accounts utter the cloning prexess, unless 
you absolutely have nc5 other way to deploy the Macs, I’m 
no! nece.ssarily talking alxxit llie ''admin" user tlxit's on every 
Mac, but more so about the end-user. The main reason for 
this is to avoid the ‘‘ByHost” preferences Issue where the 
wrong Bthemet hardware address b emlxdded in the ,pli.st 
files. If you need to fix this issue post-imaging, you can 
dowmioitd a nifty perl scTipt from: http://www.occam.com/tools 
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(upcialebyhostprefs) whidi can Qx this issue pisi-cloning if 
you don't hiive network user accounts or canVdon't want to 
create Iota) accounts after the fati. 

4. Make sure you clean up your Mac pniperly Ix!fore imaging ii 
and try not to “use" it tcx> much l?etween making images so 
that the Ictg filevS, for example, don’t reflect spurious 
information from ilie ^master" imaging Mac. If necessary, forve 
a log rotation by running the weekly maintaiancc pr(x:ess: 

Dual2^hii:/«3te/perlodic/¥eekly deanS sudo ,/500.weekly 

'Hien removing any archived log files: 

DualSgh?-:/ dean$ aude tm /var/log/'g? 

5. Another good practice Ls to lag" your image witli a small text 

file to identity it, who built it, what the imaging date was, 
and any other notes that might help you or others you work 
with rememl^er when/who/did wiiai. I favor naming the text 
tile with a "dog" extension and saving it in the /Library/Logs 
folder In order to check it with the Console Utility. 

Step 2: Creating the Image 

In Older to effectively m^ike an image from the disk you waitt 
to clone, you’ll have to btxx your Master Mac frf>m another drive, 
either an external Firewire disk (anotJicr Mac: in taiget di.sk mtxle 
will also work quite well) or another partition fFve seen G% with 
two l60 gig drives ail paniiitmecl up jiLst for this purpose), or, if you 
just want to go really slow, from the OS X Tiger ln.s(all DVD (but 
you’ll still need another drive oi- partition to s;ive your image on). 

1. Open Disk IJlility looted in /Applications/l fiilities, first, .select 
your ma,ster disk on the left-hand side and make sure that 
"Repair Disk Permissions is not grayed ouf. If it is, you1l 
need to uncfiet'k the "Ignore Ownersiiip on this Volume" 
checkbox cIkxxsc File > New > Disk Image from Folder. , . 

©00 System Info ' 

System 

Modified; Today at 12:48 AM 


^ Spotlight Comments: 


^ General: 

► More Info: 

^ Name & Extension; 

► Preview: 

T Ownership & Permissions: 

You can [ Read & Write I* ? } 

^ Details: 

g| Ignore ownership on this volume _^ 

Figure 4. Ignore Ownership toggle in "Get Info" Window 


2. Chtxise the i'blder you w;int to image, in this cusc, it'll lx.* 
AblumcsA'()urMasteri>m'c. Do not choose “Disk Image from 
Device,” as tlial could w'R*ak liavcx- with ilie ASR restore pnx:ess 
later on. llie “Fmm Folder" option results in a disk image witji 
a flexible partition si?:e that am easily fit the drive you’re imaging 
to. Tile “Frtxii Device" upikm will cause the restore process to 
revert to a file copy pnxess ratlier tlian a hkxk copy tliat will 
slow things down, and might re.sT.iit in unexjx^cted volumes sizes 
on older version of OS X. For the type of image, choose 
“Head/Write." Nonnaliy, we’d go slraigtu to “Qimpressed" which 
is Ixxh compress and re^id<inly. but we’ve ga to nuke the 
cxlopiasin ilrst. . . so it’s another step for as. . . wait until the 
image finishes, tlien go alieiid and scTub ifu* ectoplasm by 
creating a .liidden file, or issuing tlie command from A[)ple 
knowledge IxLse anide numlx-^r 3(n67 (after inseiting the Tiger 
lastall DVD). If you ilicn unitiounUremoiint the disk imiige, 
you'D see ih;ii all's well again, no ghostly remnanLs. 

New Image From Folder 


Save As: System ^ 

Where: Desktop _ 


Image Format f read/write 

Encrvpiion: [ none f r| 


( Cancel ) 


Figure 5. New Image from Folder 

3. In Disk Utility, dick the "Convert" button and chotxse the 
image you just created. For the format, choose 
\<)mpre.ssed," and give it a sligfuly different name if saving 
into tile same location, like ’'i inagc:_compressed.dmg." Go 
grab a lieverage or several, dc|xaiding on die size of your 
image. When done compressing, you 11 notice that the 
image, if a base install of OS X 10.1. i, ha.s shnink to 1.5 
gigabytes all the way down from 3.5 gigaliyles. 

4. Once done convertings we’ve goi lo prt:p or ^scan” the image 

for ASR. This process double-chccksums the image and 
aligns all of ilie bltx'ks for the fastest possi]>le restore limes, 
and, new lo Tiger, is the miiltiaisf fipiion. So, regardless if 
you don’t know what mullicast .streaming is, or if you diink 
you’re going to be imaging ’llger, read on, and make sure 
you use Disk Ulility from OS X 10.4 for the next step 
(though you .should Ire using it for all of die steps). Go to 
the Images > Scan Image for Restore. . , menu item and 
select your compressed image. Time for a Ireverage run. 
Once you’re done, yt)u've got an ASR-ready disk image. 
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O 0 O Disk Utility Progress 



Scanning of “System^compressed.dmg'' completed 
successfully. 


g Q»t } 


Figure 6. Scanning Image for ASR Successful 

BuL finit, before we go off wiily-nilly imaging and re.storing 
every single Mac in sigh!, let’s savor tlie taste of these two great 
tastes that taste great together, and look into a few other uses for 
the “chcx:olate" goodies that we ean make with our Disk Utility, 

Other Uses for Disk Images 

Disk iniage,s aren’t just useful for cloning or duplicating. 
You 11 find that applications that don’t require authentication for 
installation are often distributed on disk images (xlmgs) for drag- 
and-drop easiness. Even coin[xessed .dmgs don’t require an 
external helper application to open and mount the downloaded 
file. But beyond die standard distribute-it-on-a-.dmg practice, 
there are other great uses for disk images dial would otherwise 
reqLiire diird-party software or even extra disk drives. 

Bacf^up: using a combination of hdiutif cron, and psync or 
rsync, you ean keep a l)ooLa[)le clone of your hard drive-upHo 
date as often as you’d like. It's also a great way to “preserve” a 
configuration of a hard disk before an upgrade (as I did l>efore 
upgrading to Tiger on my PowerBuok) or lielbre sending in a 
Mac for a hard drive replaceinenl, allowing for a restt)re to that 
exact configuration, if the upgrade doesn’t go exactly as 
planned. A compressed disk image is also a nice alternative to 
.zip archive for long-term file archiving or electronic transfer if 
you know for sure that it1l be opened on another Mac, A backup 
script such as the one below will keep a bootable image in sync 
on a schedule with cron or when double clicked, if wrapped in 
an AppleScript as below: 

do shell script ''hdiutil attach 

^ /Vo l umes/MAC _BACKUP/Macinto*nh_HD. spa reel wage ’ " 

do shel] scrlpi "/usr/bln/runpsync d '/U3ers/$USER' 

‘/Volumes/Mac_liD/Users/$aSER*with administrator privilege's 
set disk to do shell script "diskutll list|grep Mac„Hl]|awk 
'fprint $5}"' 

do shell script "hdintil detach /dev/" & disk 


A couple of things to watch OLit for are to make sure that the 
.sparseimage is initially created to lie big enough to encompass 
all of ilic tkiia it miglii eventually hold, and also tliai the like 
which contains the ""awk” statement Ls properly adjusted based 
on the capacity of tlie disk, and the version of diskuttl yoii’re 
using, whether eL he Panther or Tiger. 

Security: using the 128-biL AES encryptit>n capability of 
hdiutil or Disk Utility, you1l he able to store the most sensitive 
files in a virtually Linf>reakable cipher Apple’s own FileVaulL, fjy 
die way, uses a combination of die growable .S|>arseimage 
format with the AES-128 cipher, but is actually less secure 
liecaiise the password's the same as the login password by 
default, can be unkK:ked with the system’s “Master” pas.sword, 


and is also stored in the login keychain, f'or the most secure 
settings, create a standalone AES-128 encrypted tiisk image, and 
never mm the passwQtri in your keycbaitL 

A safe, FAT haven for your HFS files: Recently, with the 
price of large (one gigabyte and bigger) keychain (USB) flash 
drives coming down to below $100 or even $49, lliey’ve 
Ixiwme viable as a data transfer tool, quickie backup device, or 
even a data recovery or rrouble^shooting rool. However, in these 
days of OS X application,s that don't have resource forks or 
create docLiments with resource forks, it easy to sometimes 
forget that nearly all of these USB drives come formatted with 
the FAT!6 tile system, which is still unfriendly to Classic Mac 
Applications, as well as Postscript Fonts, and QuarkXpress 
Documents, just to name a few. If you copy a file from your Mac 
to a FAT16 keychain drive, yoiill separate llie resource forks of 
the files and find dial your Applicadoics, Fonts, and otlier 
document may lie trashed beyond the point of recoverability. 
One way around lhi.s problem is to format yr>iir USB drive with 
the HFS+ file .system using Disk IJLility, however, lliis proliibits 
the flash di ive from ever being used with a Windows or Linux 
computer, I simply created a “sparseimage" on my USB 
keychain drive. A sparseimage is the a disk image witli a 
“gK>wablc" filesystem. When you cneaie a st^arseimage, you 
have to specify the maximum size it can grow to, but it won't 
reach that size unless you fill it up. Now, when you attach your 
USB drive to a Mac, simply double-dick the sparseimage to 
mount it. Put youi^ Mac files in there, and you'll enjoy the best 
of Ixjth worlds, withoui having to reformat your USB drive. 

Prepping for Fmulalors: often installing an emulator such 
as PcarPC (htlp://www.pearpc.nGt) or Qemu 
(htip:/ffabrice.bellard.free.fr/qemu), or even Mini vMinac 
(hnp://minEvmac.sourceforge.net) for those who warn a Mac Plus 
emuiated under O^S X requires a blank hard disk image to begin 
installation of an opeiaiing system or ho,st the applications. 



.Type$.- 

O IWorcl Processor 
® Graphics 
O Databelti 
O Spreadsheet 
O Communications 


|Tr«M 



Mini vMac 


d Hid [(lit Utdiu 


605:37 PM {2) ^ 1 


Figure 7. Mini vMac Emulator 

Di.sk Utility is Apple’s way of churning out blank 
filesystems dial can be in various fonnats, including LIES, iiFS+ 
with case sensitivity, FAT32, IIFS (UNIX File Syslerii) or even 
free space, so that your chosen emulator can recognize and re- 
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ftjimat if iLs Liioscn filesystem (like NTFS, for example) isn't 
directly supported by Disk Utility. Simply create a new read- 
write disk image, mount it, and treat it just like any other disk! 
Here’s a cjuick tip for emulation fans: don’t try the sparseimage 
formal with an emulator, it won’t work. 


/ Mac OS Extended (toumaled) 


Mac OS Extended 


Mac OS Extended {Case-sensitive, Journaled) 

Mac OS Extended (Case-sensitive) 

Mac OS Standard 


UNIX File System 





Figure 8. File System Options in Disk Utility 


Buming: just about any CD-ROM trr l>VlD-ROM (single 
layer) tliat mounts under Mac OS X Ls a candidate for burning, 
Fven though the Tiger’s Burn Folders have made it quicker to 
make multiple copies of CDs or DVDs, nothing’s quicker than 
using Disk Utility to burn disk images, since OS X preps the 
burn session as a disk image anyway, increasing processing 
Lime. If there are dist:s that need to be distributed, it’s easier to 
bum them as needed from disk itnages rather than from anotlier 
optical disc or from a folder. A multiple-session CD or DVD is 
also possible with the "Leave disc^ appendable" option—simply 
burn additional disk images u> the media until you run out of 
space. Note that lSO-9660 foniiat (used for cross-platfonn discs) 
doesn’t support multiple sessions. 

Bum Oise In: MATSHITA DVD-R 5 @ 

Wailing tor a diic la b« inierted... 

Bum Options - 

Speed: Maximum Pos$ibfe t I Test Only 

^ Erase dBc before burning 
^ leave disc appendabte 

After Bumlitg --- 

Verify burned data 

© Eject disc C Mount on Desktop 


Close Cancel } ■ Burn 


Figure 9. Burn Options in Disk Utility 

Ready, Set, Ghost! 

OK, I know you're all excited about what we can do witli 
disk images. Now it's time to start slinging them via ASR. I'll start 
with the simplesl, most straightforward way. Of course, if you're 
going to be wiping out an entire disk with tlie conlenLs of 
another, it should be pretty clear that die drive that’s going to i>e 
imaged can't be “in use," so Fll have to lx>ot from anotlier disk. 


In this first example, !li work from a Mac dial’s got the hard disk 
of an illook mounted in taiget disk imxle. The image is coming 
from a server volume. It’s a simple process to drag the source 
image into the "Source" section of the "Restore" tab in Disk 
Utility, tell it to erase the destination, and viola, in just a lew 
minutes I have a perfect clone from my image. 



Figure 10. Using ASR from Disk Utility 


Alternately, you can Ixxjt from tlie OS X Installer DVD and 
grab die .ding from a Firewire drive, then use the "Restore" tab 
in Disk Utility to image the target drive, liut booting from the 
Installation DVD is c|uite slow, so you'd even l>e [)eUer off 
htx)ling from a Firewire disk Uiat liad die Installation DVD 
copied to it as in our very first ASR example. If you're a Fttle 
more hard core than that, you can always do ii the via ihe CLl: 

pow«rniacg4r^ classadiiiin$ sudo asr -source 

-“/Desktop/Systein_asceding -target /Volumes/Firewire/ -noverify 
Password: 

Validating target.,. done 
Validating source...done 

Erase contents of /dev/diskis l 0 [/VolLi3ne.s/Firewire)? 

[nyl: y 

Erasing target device /dev/disklslO...done 
Retrieving scan infocination.. .done 
Validating sizes...done 
Restoring 

*...10..., 20...,30....40....50....60....70.,,.30,...90_100 

Reroounting target volume,..done 

Uiere’s absolutely nothing wrong with using "a different" 
hard disk to hofit from and then clone your target disk. If youVe 
deploying new machines, right out of the box, it can lie a pretty 
efficient way to go, though you’ll have to do one or two or three 
at a time. However, in some Mass Deployment situations, it's 
iielpful to lx: alile to "re-image" Macs say, at a semester break 
during a school year without having to go from machine to 
machine. If that's the case, then you're going lo need to use 
NetBoot, of wliidi the setup details, Frri sorry to say, are far 
beyond the scope of this article. However, if you've used 
NetBoot to re-image or deploy a lot of Macs, you1l know that 
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miijiing ASR over alp (Apj>le Filing Protocol) can put quite a 
drag on your network^ with each additioiial ASR session taking 
lip more and more bandwidth until all slow to a crawl 

The New Black 

Luckily for m, Apple’s been blinking a little ahead, and has, 
with Tiger, given us a new form of ASR: the multicast server. 
Mutlicasting is based on the concept of a group. 'I'he multicast 
“'data stream” (often video or audio) is broadcast one way to a 
group of addresses that fall in between 224.0,0.0 to 
239 ^ 255 . 255 . 255 , or wdiat’s also referred to as the class "D” IP 
address .spac e. If yoiiVe ever heard of a “iiroadcast storm” you're 
nut far from the concept of a multicast. Therefom, except for 
.special networks such as the Multicast backbone or “mbone/ 
multicrasting is nor allowed on the Internet. Basically, a multicasl 
is a conlinuous, one-way stream of data tliat a grouj^ of clients 
tap into to receive that data stream, and because the mntlitast is 
delivered to all clients w illing to accept it, it am move data much 
more elTicicmIy than scssit)n-orienicd afp connections. 

While multicast ASR isn’t going to help with the requirement 
to %.)ot from another disk" or to NetBoot, it could make the 
process of deploying muilipic Macs much fustcr than ever 
before. I decided to put multicast ASR through its paces to see 
how well it w^orked in the early releases of Tiger. First, I w^as 
dciighied to llnd that the ASR multicast server ck)c^ not rccjuirc 
OS X Server, but does require that the ASR multicast client be 
booted from a iiger disk. That doesn’t mean, for example, that 
I he image IxHng multicasl couldn’t he OS X 10.3, or even OS 9 
for that matter. 

i1ie steps for setting up an ASK multicasl server are rather 
simple. First, prepare the image as in the insmicnons above, but 
if using an iimige prc[)arcd under Disk Utility for OS X 10.3, be 
sure to scan the image for ASR again, which will make it 
mulricast compatible. Then, setup the server from the Oi: 

ioiacg4:“ moijtadiiiiiiS defaults write '“/Desktqp/aarcast “Data 
Rate'^ -int 3000000 

iiiiac£4:“ mostadmin$ defaults write ^/Desktop/asreast 
'"Multicast Address" 224.0,0.123 

ImacgA:"- tiiOfitadmnS defaults write '^/Desktop/asrcaat "DHS 
S^irvire Discovery'' -hool true 

Note that although the man page for ASR .suggests that you 
cieate the “.plist" hlo (asreast in the examjile alxjve) in the /imp 
directory, I’ve had prohleim witli that, so 1 just throw it on my 
desktop or in another folder. The two recjuired 
.settings govern the rale of the multicast, which is 
very imix)itant for Ixjth perfonnance and “network 
safety," which Til ger to in a minute. The second is 
liie multicasl address that ihc serv'cr uses. That's not 
the address for the client to connect to, liowever, but 
note that third, optional setting “DNS Service 
Di.scxwery’’ -Ikk)! true, which activates BonjourCa.k.a 
Rendezvous or Zcroconf) for die multicast server. 

Once all those are entered, the multicast serv^er can 
be started with: 


liiiacgA:*' ]nostsidniifi$ sudo asr source -/system^asr. duig 
-server ^/Desktop/asreast.plist/ 

Password: 

Multicast server configuration; 

DNS Service Discovery: true 

Data Rate: 3000000 

MulLicast Address: 224.0.0.123 

Ready to start accepting clients 

Starting stream Tuea May 31 05:09:31 2005 


And the multicasl client, when re^idy to connea can do it tlris way: 

cla5sadmns-power‘tnac'g4;“ classadminS sudo asr -source 
asr;//iniacg4 .local -target /Volumes/System -tioverlfy -erase 
sword; 

Validating target...done 
Validating source...done 

Erase contents of /dev/disk0s3 (/Volumes/System)7 

[nyj : y 

Erasing target device /dev/disk0s3.. .done 
Retrieving scan information...done 
Validating sizes...done 
Rob toring 

.,..10....20....30....40....50....60....70....80....90....100 
Remounting target volume... done 

It’s interesting how well dial works: even if die A5R 
multicast server has a dynamic IP address, you can connect to 
it by it.s “compulername,kx:ar if youVe enabled the “DNS 
Service Discovery" .selling, l>ui then lliat only works on ycjur 
local subnet, whicli incidentally, is where the ASR multicast 
would most likely be contained, unles.s multi<::ast forwarding ha.s 
been property configured on your IAN. 

Multicast Ups/Downs 

After giving ASR mutliaist a workout, IVe come to several 
cortclasions, none of which are very surprising. At its peak 
performance, a mullic,^tst ASR restf)rfc: is a liulc bit faster than a 
single restore over an afp conneaion or even a locally attaciied 
Firewire disk, llie difterence is really apparent, however, when 
yt>ii nin .several concurreni multicasl a.'.sloTTes, which all take 
vinually die same amount of time as a single restoie, whereas the 
afp restores stall fo Ixig. I could see, that under ideal conditions, 
rnultiaast ASR could cut the rx:sTore iimc:.s by nearly 75% for a group 
of 100 netv^x)rk-ixx)ted Miics, depending on the size of the image. 

Yet running an ASR multicast sei-ver isn't without its pitfalls. 
You have to carefully evaluate how much muliica.st traffic your 
LAN can handle. . . a.s I found out when I first fired up my 
multicast server. A tepdump of the network interface of all of 
the computers in my lab revealed the following multicast traffic: 


04:05:58.625372 IP 192.168.0.90.55035 > 224.0.0.123.7800: DTP, length: 1466 
04:05:58.626846 IP 192.168.0.90.55035 > 224,0,0.123.7800: UDP. length: 1466 
04:05:58*628306 IF 192.168-0,90*55035 > 224.0,0.123,7300: UDP* length: 1466 
04:05:58.629778 IP 192.168.0.90.55035 > 224,0.0.123.7300: UDP. length: 1466 
04:05:58.631251 IP 192.163.0.90.55035 > 224.0*0.123.7300: UDP, length: 1466 
04:05:58.632740 IP 192.168.0.90.55035 > 224.0.0.123.7300: UDP* length: 1466 
04:05:53.634217 TP 192.168.0.90.55035 > 224.0.0.123.7300: UDP* length: 1466 
04:05:58.635730 IP 192*168*0.90.55035 > 224.0*0.123.7800: UDP* length: 1466 
04:05*58.637169 IP 192,168*0,90*55035 > 224.0.0.123.7800: UDP. length: 1466 
04:05:58.638630 IP 192.168*0.90,55035 > 224*0.0.123*7800: UDP* length: 1466 
04:05:58.640113 IP 192*163.0.90*55035 > 224.0.0,123.7800: UDP* length: 1466 
04:05:58.641579 IP 192.168.0.90.55035 > 224.0.0,123*7300: UDP* length: 1466 
04:05:58.647351 IP 192.163.0,90.55035 > 224.0.0.123.7800: UDP* length: 1466 
04:05:58.(348753 I? 192.168,0.90,550.35 > 224.0*0.123.7800: UDP* length: 1466 
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which seemed to a little bit tcx) much for some of our other 
nciwork services such our 3Com NBX VOIP phone system, 
which went offline, or my internal Nagios test server, whicli 
promptly emailed me the following warning: 

• * ** * Nagios * ‘ * 

Notification Type: PROBLEM 

Service: current users 
Host: nagitest 
Address: 6^,3^,21^,1S4 
State: CRITICAL 

Date/Time: Monday May 30 05:3B:43 CET 20D5 
Additional Info: 

GHECK_NnPE: Socket timeout after 10 seconds 

And then a minute or so after shutting oft' the multicast: 

***** Nagios 

Notification Type: KRCOVEHY 

Service: current users 
Host: nagitest 
Address: 64.32.214.184 
State: OK 

Date/Time: Monday May 30 05:43:22 CET 2005 
Additional Info: 

USERS CK - 1 users currently logged in 

Other anomalies included DNS kxikup timeouis, wel> plages that 
failed to load, as well as afp autlientication hangu|:Ki. It seems ftiat 
the multicast rate suggested by Apple in the ASR in;m page is a little 
ttK) high for pmctiaii use tor the networi< at our offitie, so cutting it 
in liaif ^seemed to iieip somewimi, I ml realisticaliy it seemed .safer to 
cut it to a third of the suggested mte, ZCXXXXM), Al.st), any other 
multici.sting devit:es (phone systems, video sircTiming, etc.,) or 
running two multicast servers simultaneously will absolutely kill 
your network. Also to mke under consideration is kiweiing the data 
fate at the client side to account for Macs with slower hard drives, 
less RAM, or sk)WLT network <:onnections. It's pretty obvious to me 
tliat ASR multic’ast would l:>e test am on an isc:>lated switch or on a 
network where everyone had gone home for the day or the 
weekend, lls a pietty harsh mistress. 

In the Black 

If youVe Ibllowed along with me up to this iioint, you 
might have aheady formulated the question thatll 111 answer for 
you right now. Is ASR Open-Source software? Ihe answer's a big 
cn-oh. So what's ilie Source Hound doing w'riiing aixmi 
something not-open-source? Well, iPs free, which is close 
enough for me. Oh, and did 1 fail to mention that Symantec 
Ghost Stans at $69 a seat? Of course, tfie c'tcst goes down with 
volume buys, but the last group of thirty licenses f purchased for 
a Windows customer came in at about $400, and who knows 
what the uf)grade will exist when Longhorn arrives. Who was it 
tliai said Macs were more expensive tlian PCs? 


If you think / like Open-Source .software, tune in next 
month as 1 sit down for a virtual interview with the grand piihah 
of Mat: Geckery, Drunkenhatman of Drunkenblog 
(http://www.drunkenblog.com). Well te discussing a wide range 
of topics from Open-Source to software development at Apple, 
QuickTime 7, Inteilcctua! Property and the GPL, and oh my! 
Lverytliing, including the cow! 


Jill 


About The Author 
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By Scott Knaster 


Have you seen the incredil>le RSS Visualizer screen saver 
in Mac OS X Tiger? If you haven't, go clieck it out now: you'll 
Find it in the Desktop & Screen Saver panel in System 
Preferenc:es. Figure 1 gives you the flavor of what it Icxiks like, 
hut you really have to sec die wtjrds swwping and Twisting 
around on die screen to get the full astonishing effect. 





Tyfanrujsaums Wren? 

Do tthnouon tfilt The flotJ^n is f4r from f*r- 

AccsfdifiQ to *I»nasivm Anci«fn TotsJts, Nnw 
OiJtJWtf t r.«w tKhltjH H ntw York 


Figure 1. RSS Visualizer is a hypnotically cool screen saver. 

One of die best things about RSS Visualizer is that it wasn't 
cre-iited in the old-fashionecl screen saver way by writing a little 
Ctxxyj program. Instead RSS Visuaftzer was built with no axle 
wliaLs<x*vcT using a remarkable new tool called Quartz 
Composer In this article, we’re going to take a Icxjk at Quartz 
Ct^mptxser and get a feel for what it dtxs and how it works. 

Quartz Conifx>ser Ls an application included with Xcode 
TfX)Ls 2.0. Quartz Composer lets you play with and learn alxxit 
the cool Quartz graphics features built into Tiger withoui 


having to study APIs or write ctxJe. Drxruments you create with 
Quartz Composer, called compositions, can l^e nimed into 
QiikrkTime mtwies or OS X st'reen savers. In this article, we’ll 
use Quartz Composer to create a nifty screen stiver without 
veiy much efTort. It will take a little while to follow all the 
steps, but I promi.se the re-,sulls will lx w{>rthwhile, 

Here's a friendly warning: Quartz Composer is 
supercool and highly atidictive. Before you start using it, be 
sure you have several hours (or perhaps an entire night) to 
dive in and try diings out, Ixcause you might find it liard to 
walk away. 

And now, let's get started. 


Compose Yourself 


'lb l>egin, go lo /Devdopcr/Applicatkjns/Ciraphic Tools 
and mn Quartz Crjm|X>scT. As the program starts up, you 
might get an alert complaining tliat your Mac's videti hardware 
won’t support all the program's grejiiesi features, but that's 
OK. If you get the alert, read wliat it says and click Continue. 

Next, you see the New Composition Assistant offering 
several types of templates to start our composition. For this 
example, weVc going to start IVt>ni scratcli, so just click 
Cancel to make the Assistant go away. 

Use File > New to create a new, empty composition. 
You see two windows: The one that looks like a 
checkerlxyard is called the viewer; and the other is the editor. 

On the left side of the editor w'lndow, make sure Patch 
Librar>^ is selected. In Quartz Composer, a paicli is an 
individual grapliicaf elerncni or pnxcss. Patches are the 
building l>lotks you use to make compositions. Well start 
this one with a cube. Look down the Name column in tlie 
Patch Library until you find the patch named Cube^—il's in 
tlie Rendcrer category. Double-click Cube to add a cube 
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paicii lo the 
c o rn p o Js i L i o n . 

Instantly, if not 
sooner, a box 
labeled Cul)e shows 
lip in the editor. 

There’s also n cube 
showing in the 
viewer—you can’t 
see if, because it has 
no coltJr or texture 
yet, but you can tell 
it's there because 
it\s bulling out the 
grid background 
(Figure 2). 

Lets be honest 
about this: our culie 
is totally boring right 
n(tw. Why, it's barely 
a cul>e al all. Rut if 
you take a look at 
the cube patch in the 
editor, you see that it 
has a bunch of values wc can use to fill it that should tnake 
it far more interesting. Let’s start by [>uning something on the 
from of the culx^. In the Patch Libmry, find Image Importer 
(it’s in tlie GencraLor caiegory) and double-click to add one 
to the comjx>sition. 

Note: when you’re adding a patch to your composition, 
there are various ways to find the patch you’re looking for. 
By default, the Patch Library is soned by caiegory. You might 
find it more useful to alphabetize die patch names—cirt k the 
Name coluiim to do that. If you know any ]iart of lire name 
of the patch or category, you can type text in the Search In 
Libraries field to get instant result.s. Note dial some patches 
have a bullet in front of their names. Tlie bullet indicates that 
these patches work best with graphics hardware that’s nut 
pre.seni on the computer running Quarts Composer, so they 
will run slow^ly if used on this computer (The alert you might 
have seen when you started up Quartz (Composer was 
warning al>out dus.) 

Cljt:k the new Image Impoiter patcli to select it. Click the 
Inspector button in the toolbar (you can also choose Editor 
> Show Inspeaor or press Command-l). 

In the Inspector, click the poj)-up menu and choose 
Settings. 

Face Front 

Now you need to find a nice picture to put on a cube 
face. Click Import Fmm File and navigate to any image you 
want in almost any format, including JPEG, TIFF, PNG, TIFF, 
and PDF For liest results, pick an image dial’s square or 
nearly so. If you can’t find any images you tike, look in the 


current user's 

Pictures folder. 

When you locale die 
image you want to 
use, double-click it. 
If you prefer, there’s 
a cool shortcut: Drag 
an image file and 
drop it into the 
Image Data area in 
the 1 nspecton '1 he 
image yon picked 
should ajijxnir in die 
Image Data m'ea. 

Now we'll tell 
the culx to display 
the image you 
selected. In the 
editor, click the little 
circle next to the 
word Image in the 
Image InifKmer and 
drag to the circle 
next to Front Image 
in die Cube patch. You should see a spaghetti-like strand of 
yellow wire strung between the two circles or ports (Figure 
3 ). 'lake a look in the viewer window—the cube now has 
ilu^ selected image on its face. It’s not so lame any more. 



Figure 3. All my tubes and wires, careful notes, and 
antiquated notions. 


One of die most powerful features of Quartz Composer 
is its ability to aeate composidons tliat don’t just sit there— 
Lltey live, breathe, and move. To make your cube gel aclive. 



Figure 2. Our composition starts with a cube. We only know it's there because part 
of the background is obscured in the viewer window. 
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you must change some of iLs seiLmgs repeateclly over time, 
la paniciiiaa if you diange the rotation settings, the cube 
c hanges its orientation, and you sSee different parts of it. By 
changing the rotation v^ilues over and over, the ail^e spins, 
yuartz Cnmpo.ser includes a patch called an interpolation 
that supplies an ever-changing stream of values. Find 
Interpolation in the patch library and double<lick to add 
one to the composition. 

Click the inlcqx>Iation patch to select it, and then click 
Inspected to see its values. We want the cui)C to rotate by 
varying its orientation Ireiween 0 and 360 degrees, so we ask 
the interpolation to supply values that go from 0 to 360. In 
the Inspector, click the pop-up menu and choose Input 
Parameters. Leave Start Value at 0 and change Jtnd Value to 
360 . The Duration value deiennines how many seconds it 
takes to complete the interpolation. Set that value to 20. 
Leave the other value.s as they are. 

Now that you have a source of values from 0 to 360, you 
need t.o supply those values to the cube for its rotation. Drag 
from die Result pon of the interpolation to the X Rotation 
[Xirt of the cube* Take a look at the view^er window. The 
ciil">e is in motion! You should see the cube tumbling 
endlessly forward, all faces wliite except for the fnjnt, which 
still lias an Image on it. Tliat’s pretty neat, but w^e're just 
getting staned. 

Getting To Spin Alley 

Because the cube is only changing its x-rf.>tation, we 
never sec its left and right sides. To fix duiu we can spin the 
culie on its y^axis at ihe same lime, and offset the z-rotation 
a bit (but not change it continuously). In the editor, drag 
aniKlier connection from the Results port, this lime h(K>king 
it to the cube’s Y Roralton. Click the Cuf>e patch, and then 
click the Inspector huiton. Go to the input Parameters panel. 
In the Z Rolation field, type 90, and then close the Inspector. 
Now the culte is tumbling, and all ,six faces eventually come 
into view. 

Quartz Compo.ser is drawing the cube over and over 
again, but something i,s missing: You see only one frame of 
the cube animation at a time. What’s liappening to the 
previous frame.s? As a development and debugging aid. 
Quartz Composer automatically erases the viewer l>efQre 
every redraw, 'fills auroniaiic erasing won't happen w'hen 
you use the composition outside Quartz Composer. To see 
what diat will look like, choose Viewer > Disable 
Backgrerund Emsing and take a kxjk at t(ie view'cr You soon 
get a big smear of culx!s everywhere ids Ix'en drawn (Figure 
4). That's not what you want. To prevent this from 
liai>[>ening, you need a patch that era.ses each old frame of 
the culie before drawHng a new one. Find the Clear patch in 
the Patch Library and double-click to create t>ne. 



Figure 4. The cube draws over itself repeatedly and 
eventually creates a big ugly mess. 


You’ve added the Clear patch, and now tlie viewer window 
is...txjmplerely black! Nice job, Picasso! What's gone wrong? Take 
a kx)k at die yellow numliers in rhe upper-right aimer of the 
CuIk? atid Clear patches, Ihe numlxT for Culie is 1, and Clear is 
2, Ihese numbers repmsent tlie rendering layer for each patch. 
Ikcaiise tl ic Clear patch was just added, it got rendering layer 2, 
the last layer in this composition. Qiiaitz Qnnposer draws 
compositions into an offsciven buH'er tlicn moves the result onto 
tile sc’reen. Qimfxjsiiions are processed in order of dielr 
mndcring layers* So e*ich time through tlie comjxisition, the 
culx* Is draw^n (rendering layer 1), tlien cleared ro black 
(rendering layer 2), then drawn on the saeen! Ikit's why you’re 
seeing only a black screen in the view*er. 

To fix this problem, we need to reverse the order: clear 
the screen first, and then drtiw^ the cube. To make iliis 
change. Control-click the title of the Clear patch and choose 
Rendering Layer* Now' pick Uyer 1. Note that the Rotating 
Culie's layer automatically ciiange.s to 2, and in the view^er 
windt>w, your culx is back with the background now cleared 
to black, just as nature intended. 

Picture This 

Sure, you've got a lovely rr)taling cube, but five of the 
faces are blank* That’s still some boring cube! We i:an make 
it lieitcT by puttltig things on the other fac:es, using various 
patches to show liow ccxil Quartz Composer is* Start by 
adding an image from a Web page. Find the Image 
Downloader patch and double-click to add one. Open the 
Inspector, go to the Input ParaTneiers panel, and type 
http://images.applecom/home/2005/images/ipodfamilyphoto20050223. 
jpg into the Image URL field. 

Connect the Image port of the Image Dow'iiloader patch 
to the cube's Left Image port. Tlic Web image should 
iastantly appear on tlie right face of die aimbling cube. (If it 
doesn’t, double-clieck to make sure you typed the URL 
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correctly, or type lIic III^L of another imiige on the we[>.) 

*llie next hice is practical; it’s going to show the time of 
day. To make it, add three patches: System Time, Dare 
ForinaLtcT» and Image With String, Run a wire fix^m System 
lune Co Dale Formatter via their Time ports. Make a 
connection from Date Formatter to Image With Siring using 
their String ports. Finally, comieci die Image olUjilil From 
Image With Siring to ihe Right Image port on the cuIk*, Now 
you have the lime of day on die right face of tlie cube. 

Tlie time display is kind of messy; it's .scaled and haul to 
read, ceitainly not up lo our fancy-pants gmphics stiindavds. Let’s 
llx that. Click Image With String, tljen clic:k Inspector, and go to 
the Settings panel. Cliange Ixiih the Ht>rizonlal ami Verticil 
Alignment to Center. Pick a diflerent font if you like. Click Fixed 
Dimensions (in pixels). Fill in an Image Size of 1024 by 1024, and 
a font size of 200. the time now Icxiks a lot lieiler. 

Showtime 

Wouldn’t it be cool tf one of the cuf^e faces continuously 
showed a QuickTime movie clip? Let's do it. Add an Image 
With Movie patch to the composition and open the Inspector. 
Go to the Input Parameters panel and type the path to a 
QuickTime mt>vie (for example, 

/Users/yourName/Docunienis/myMoviejnov, or dowaiload a 
movie trailer from w"ww,apple,coni/quickdme anrl then type 
its local path). Connect the Image With Movie putclFs Image 
output to the Cube\s Top Image input. Take a look at the 
viewer—you should see the movie playing on the tiilie's top 
face as it rotates into and out of view. Awesome! Figure 5 
shows the composition at thi.s point, 



Figure 5 . The composition now has images on four 
faces (this picture shows three). 


Til ere are still two blank faces on die culx:, l>ut III leave 
those to you and your creativity now^ diar you have a feel for 
how it works. Here are some ideas you c^an use to dress up 
those faces: 


Use a Hast Info parch to display various liiLs of 
interesting and obscure information, such as tile cunent 
user name, computer name, OS vei^ion, or Cl^lJ load. 

Set the hackgroun<l color of the cube faces by using the 
Inspector to change the Front Color, l^ft Color, and so on. 

H(K>k an Interpolation patch to an RGB Color patch ro 
continual ly tliange the colors you put on the faces. 

When youVe all done with the cube, it's easy to make it 
into a screen saver. Just use File > Save As and navigate to 
die current user's Lihniry/Screen Savers folder. Save the 
composition into tliai folder. Wdien you go to System 
Preferences and click Deskiofi ^ Screen Saver, you see your 
composition at the Ixittom of the list, available as an ofheial 
screen saver. Click, select, and enjoy. 

Nme that w'lten you install Tiger, it doesn^t create the 
u.seris Librar>VScreen Savers folder by default. If yon 
navigale there and find no such folder, you can click the 
New Folder hLiiLon in die Save diakig to create it. 

Like Disneyland, a Quartz Composer documeni is never 
truly finished a.s long as there Is imagination left in die 
world. If you want to play more with Quartz Composer, liere 
are a just a few of die tnany inieresiing features you might 
warn to investigate: 

Use a Lighting patch to gci ttic nifty effect of shining 
a light on objeers in your composition. 

Check out die Clip Li[irar>^ in ihe editor wandow to add 
a pulsating Apple logo or shiiiuiiering liackground. 

Add a MtiLtse coniroller to use the mouse to slide your 
objects around on die s<::reen. This wont work in a screen 
saver because moving the mouse dcaciivates the .screen saver. 

Grab a Random patch to feed random inputs lo an 
abject, .such as the location values for a cube, to make it 
warp around the seteen. 

Tiger's KSS Visualizer screen saver, built w ith Quartz 
ConifKiser, uses patches that read KSS feeds and display 
them in a composition, among many other crxil features. 
You can open iiSS Vi.suali2er in Quartz Composer and spend 
houm or days studying it. If you do, you’ll get a strong 
education in the features of Quartz Composer. 

For more ideas about wliat you can do witli Quartz 
Qimposer, check out the folder at /Developer/Examplcs/Quartz 
Composer. Quartz Composer is an amazing tool for aeatiiig 
heautihil iimges widiout any pRigramming. Fnjoy exploring it - 
but don't foiger to go back to your regular life from time to time. 

_ 
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QUICKTIME TOOLKIT * by Tim Monroe 


Baoc To The Future 


Developing Applications With 
The QuickTime For Cocoa Kit 


Introduction 

In several earlier articles (^'T'he 
CoaxanuLs"* in M:icT&:h, December 2002 and 
“Animal Crackers” in Januaiy 2003)* we look 
a Icxik at developing QuickTime appliaitions 
using ihe Qx-oa classes NSMovie and 
NSMovieView. We found that the-st* tTa.sscs 
provide reasonably good support lor 
displaying and editing QuickTime movies. 
Tliey art^ tightly integrated with tlie CtxxKi 
application framework as a whole, and they 
succeed marvelously at shielding tlie Caxroa 
pR)graniincT from tlie Caiten data strutiures 
and APIs ruitive to Quicklltne. 

Nonetheless, the two classc*s NSMovie 
and NSMovieView provide only a limited 
selection of methods for managing 
QuickMune movies. We saw that we fairly 
cjuickly needed to subclass NSMovieView to 
ovenidc its default behaviors (for in.stance to 
support a contexiual menu that was 
sensitive to the type of movie I>eing 
displayed in a view). And we needed to add 
categories to these classes to extend them in 
fairly simple ways (for instance U) show and 
hide specific l>uttt)ns in die movie controller 
bar). NSMovie and NSMovieView are tine 
as far as they go; the main problem wiili 
them is that they don't go very far at all 
T 1 ic 7 arc intcniionaJly limited to movie 
playl>ack and simple editing, and even there 
they sidestep the opportunity to incijrporaie 
movie opening and playlxick Ixfhaviors that 


even a simple appliaition would probably like to exhibit (such a.s 
loading movies asynchn)nously or automatically nncling external 
taigel movies for wired actions). 

Apple has recently introduced an enlianced set of Gxx>a 
classes that supjx^rt QuickTime movie playback and editing, called 
the QuickTime ForCcxxm Kit or (more brieily) tite QIWl This new 
framework llrsi shipped with Mac OS X 10.4 GT iger”) and is aLso 
available for Mac OS X lOJ.^) (“Panther") as part of QuickTime 7. 
In this ariick' and the next several articles, I want to examine the 
QTKit framework in some detail. Tlie QTKii is an important piece 
of new CtKOa technok^gy that is already used by key applications 
such as QuickTime Player (on Tiger and Pantlier) and SjX)llight 
(on Tiger), It promises to .significandy simplify the process of 
adding multimedia cajxibilitics to Cwoa applic:itions. 

In iliis article, weTl take an intnxiuctory ItKik at QTKit's 
clas.ses and their methods, as well as the sinictures and 
functions it uses to manipuble times and lime ranges. We'll see 
how U) use the QTKit to display a QuickTime movie in a CtKoa 
d(KUmerit window and control the playliack of that movie. WeTl 
also see how to use QTKit jnethods in a commaiid-iine tool. In 
the following articles, well look at more advanced uses of these 
new classes. WeTl learn how to use the QTKit to export and 
flatten movies, and how to perfonn mt>re refined movie editing, 

(QuickTime for Cocoa Kit Overview 

The QT'Kit is a Coc:oa framework tliat provides support for 
opening and displaying QuickTime movies, and for performing 
varitjus sorts of manipulations on those movies. Note tliat I did 
not write: ''QlTCit is a framework that provides a Cocoa wrapper 
for all of QuickTime”. Tliere are laige pieces of QuickTime 
functionality dial are not addressed by the version of QTKit 
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I n several earlier articles (“The Cocoanuts” in MacTech, December 
I 2002 and “Animal Crackers” in January 2003), we took a look at 
developing QuickTime applications using the Cocoa classes NSMovie 
and NSMovie View. We found that these classes provide reasonably good 
support for displaying and editing QuickTime movies. They are tightly 
integrated with the Cocoa application framework as a whole, and they 
succeed maivelously at shielding the Cocoa programmer from the Carbon 
data stmctures and APIs native to QuickTime. 


rcicascd in QuickTinic 7. For iiistiince, tlieie are no classes for 
capairing video or sound data (therel^y wrapping QuickTime’s 
sequence grabbing capabilities), and there are no ciasscxS for 
working direcily wiih spriles or wired actions or atom containei's 
or QuickTime VR hot spots, llie version of Ql'Kit released in 
QuickT'ime 7 should be viewed as a very good start to the 
Ccxoaization of QuickTime, not tlie conqdeted journey. 

QTKit Classes 

'Hie QTKW fmmework currently exposes five classes: 
QTMovie, QTTrack, QTMedta, QTDataReference, and 
QTMovieView. QTMovieView is just what you would expect: it’s a 
subclass of NSView that t'an display QuierkTitne movies and allow 
ilic u-ser to internet with tlieni. Figure 1 shows a Cocoa window 
whose content area is completely tilled by a QTMovieView. 



Figure 1: A window that contains a QTMovieView 


As you can see, this QTMovieView contains the 
standard movie controller ban However, you can hide 
the bar by invoking the setControllerVisible: method, 
like this: 

[movieView setControllerVisible:NOj: 

The QTMovieView class provides methods for 
controlling movie playback, positioning the current movie 
lime, and performing edit operations on the current movie 
selection (cut, coj?y, paste, etc.). It also provides a 
contextual menu that allows access to a iiandful of iliese 
methods, as shown in Figure 2. 



Figure 2: A contextual menu in a QTMovieView 
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In QTMovieView, tliis menu is laily contextual; for a Flash 
movie, the menu is the one shown in Figure 3- 



Figure 3: A contextual menu in a Flash movie 

You associate a QuickTime movie witli a QTMovieView 
object by calling the selMovie: method, which takes a QTMovie 
object as its paranieier. 

QTMovie is the key class in QTKit. It is a Ccx’oa wrapper 
for a QuickTime movie and a QuickTime movie contraller. 
QTMovie provides an extensive selection of methods for 
opening QuickTime movies from files, URLs, ihe Pasteboard, an 
NS Data object, and data speciiied by a QuickTime data 
reference. For instance, if filename is the full j^atliname of a 
QuitikTime movie file, this line of code creatc-s and initializes a 
QTMovie object ass<x:iaied with that movie 11 Ic: 

fIQTMovie alloc] InitWlthFile:filename error:nill: 

Notice the error parameter; ifs a fxnntcr to an NSError objea 
that is used to letum to the caller an indication of any error dial 
occurs during the movie initialization. Ali QTMovie initialization 
methods use ilrai parameter. 

QTMovie also provides an extensive selection of 
mediods for getting and setting movie properties, controlling 
movie playliack and current time, getting and setting the 
movie selection. and editing the movie scicciion. Well 
encounter a number of these methods in the following 
discussion. 

The remaining three classes, QTTrack, QTMedia, and 
QTDataReference provide Cocoa representations of 
QuickTime tracks, media, and data references, respectively. 
For simple movie playback and editing, you wail not need to 
use these classes and we will not discuss them funhci in this 
article. 


Time Structures and Functions 

lime positions and duntions are managed in QTKit using 
two structures, QTTime and QTTimeRange, Note that these are 
not objects, since creating an oliject each lime we needed to 
specify a location in movie or a duration of a movie segment 
would have been onerous and inefficient. Here is the 
declaration of tfic QTTime sUaicturc: 

typedef struct [ 

lon& long timeValuy; 

long timescale; 

long flags; 

] QTTime; 

The time Value field is a 64-bit value that indicates a time 
value. This value is inlcrpreled relative to the timeScale 
field, wTiich indicates the number of units per second. The 
flags field is usually 0; in rare circumstances the 
kQTTimelsIndefinite flag may [>e set, indicating ihat tfie 
other two fields are not to be trusted. (This might happen if 
you try to do an operation on a QTTime structure whose 
timeScale field is 0.) 

The QTKit pmvides a liaixlful of utility metliods lor inirkiliziitg 
and imnipulating QTTime stnicrures. For inskmce, QTMakeTlme 
lakes a [ime value and a lime scale and ilien returns a QTTime 
struclLire. We can specify the four-second point in a movie like lliLs; 

QTTi me fitartT ime = QTHakeT I me {4, I); 

Tlie QTTimeRange .structure specifies a lange or duration 
of time values; it’s declared like this: 

typedef struct 1 
QTTime time; 

QinUme duration; 

1 QTTimeRange: 

QTKit Behaviors 

One metric of the value of a framework is not the 
number and variety of the methods you can call, but (so to 
speak) the methods you don’t need to call — that is, 
capabilities that are provided ‘Tor free** by the framew^ork. 
lliis is an especially valuable metric for a Quicklime 
fra me work, as the operations ret] ui red lo (say) open and 
display a QuickTime movie can easily hcccmie quite 
numerous. As we’ve seen in earlier articles (paiticularly 
"Loaded'’ in MncTcch^ September 2002), loading a movie from 
a remote senxT witliout blocking the application (that is, 
synchronously) requires a fair amount of work. We need to 
make special API calls to .start the asynchronous loading and 
then we need to monitor the movie’s load state until il has 
reached a certain threshold. And w'e need to explicitly task 
the movie all the while. In Ql'Kit, id! movies are loaded 
asynchronously, with absolutely no extra work required by 
the developer. And QTKit takes care of tasking the movie at 
appropriate intervals. Loading a remote movie 
asynchronously is as simple as executing initWithURL:error:. 

Here are a few mcjre of the behavior provided Ibr free to 
QTKit client applications: 
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Multi-level undo for editing operations Q'lKit takes 
advantage of existing Coc:oa classes to support mulU-level 
undo and redo for editing operaticms on a QTMovieView 
object. In earlier versions of QuickTime Player, for instance, 
only the most recent edit operation is undoable, 

Intcrmovk* communication, QTMovie aulonratically finds liie 
target of a wired action that is targeted at another movie. 
Drag and drop editing. Q'PKit supports dragging a movie 
selection out of a QTMovieView and dropping it into any 
otiiLT object dial can accept dragged movie data; dragging 
between Cocoa and Carbon applications is fully 
siipporred. 

Live resizing. A QTMovieView o])jcct can be resized while the 
assrxiated movie is playing. Earlier versions of QuickTime 
Player drew a gliost outline of the movie frame and window 
frame during resizing and redrew the nKJvic data only when 
the final size liad been reached. 

Constant pitch audio. In previous versions of Quick'llme, 
selecting a faster playback rate would alter the pitch of the 
audio (resulting in the infamous “chipmunk'^ effect), QTKii 
automatically take.s advantage of improvements in the 
QuickTime 7 audio architecture to maintain a c:onstani pitch 
during accciemtcd movie playback. 

Keep in mind that these are only a few of the improved behaviors 
that all QTKii c lient applications exiiibit as pait of using QTKii, 

Movie Editing 

Let’s begi[i our hands-on exploration of the QTKit framework 
by seeing how to delete a segment of a QuickTime movie using 
Q1Xir APIs, First, we need to open the movie file; if the mcjvie filc^ 
is kxratcd at /lmp/safnple,mov, we can use tliis line of code: 

QTMovie 'movie ” [nTMovie movieWitiiFimp/sample.mov'* 
etrocMiil] t 

Next we need to specify tlie movie segment that is to Ixi 
deleted. We can use the QTTlme and QTRmeRange staicritre,s 
and iLsscx:iated functions to do that: 

ftTTime startTijne ^ QTHakeTiJtie (4, 1): 

QTTime duration = QTMakeTiiiie(2, 1); 

QTTimoRange range = QTUakeTimeRange(atartTime. duration); 

lhe.se lines of code specify a segment that is two .seconds long 
beginning four seconds into the movie. 

We can delete the .segment by using the QTMovie method 
deleteSegment:, like so; 

fmovie deleteSegmetit :rangel : 

There is however one gotcha: by default, a QTMovie object is 
Lineditabie, So we first need to set the editable state of the movie 
like this: 

[movie seizAttribuLe: [&fSNumber numbsrWi l hBool: VES] 
forXey:QTMovieEditableAttribute]: 


llie method setAttributedorKey; is the standard way of setting 
an atiril>ute of a QTMovie object. The header file QTMovie.h 
lists a large numt^er of keys for this method. 

Finally, to save the edited movie back into the original file, 
we can execute the updateMovieFife meihcxJ: 

[movie updateHovleEile] ; 

Movie Exporting 

Let’s consider another easy example, Suppo.se we want to 
save an existing QuickTime movie file as a 3 CtPP Hie (which is 
streamable io cell phones and other tenninal devices that conform 
to the 3GPP standard). In this case, we can use the 
writeToFile:withAttributes: method supplied by QTMovie. Ibis 
method is usetl to expon or flatten a QuickTime movie, depending 
on tlic contents of tlie attributes dictionary. Listing 1 shows a 
complete command-line tool that creates the dictionary, adds the 
appropriate objeas and keys, anti tlien exjxarTs the mt)vte. 

Listing 1; Exporting a movie as a ^GPP file 

//import CQTKlt/QTKit. b> 

int main (] 

[ 

NSAutoreleasePool ‘pool = [ [NSAatorelea^^eEool allcjcJ 
init]: 

QTMovie *movie = [QTMovie 
movifiWithFlle:@"/tmp/sample.mov” error:nil]; 

NSDicttonary *d1ctlonary = [NSUlctionary 
dictioTiaryWithObjec tsAndKeys: 

[MSKumber iiumberWithBool: YES] , QTHovleExport. 
[NSMumber numberUithLorig: kQTEileTyP^^tjPE] * 
QTMovleExportType, niij : 

[movie writeToFile:^"/trap/sample.3gp” 
withAttribotes!dictionary]; 

[pool relesso]t 

exitll) r 
I 

If this code is saved into the file mov23gp,m, we can create 
the executable command-line tool by issuing this command; 

% cc -0 mov23gp g iuov23gp.m framework Foundaiion 
framework QTKit 

Movie Display 

Command-line tools are useful enough, hut chances are 
youTe more interested in opening and displaying QuickTime 
movies in a window. Let’s see how to work with a QTMovieView 
object. For this, well need to use Xcocle and Interface Builder. 

liiunch Xcode; select ""New Project...” from the File menu 
and then select “Cocoa Document-based Appl^cation^ as shown 
in Figure 4. 
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Figure 4: Creating a new multi-document project 

1’he Assistant theii prompts us for a project name and 
loan ion; let’s call our project ^^KliEeT:” and save it in our liome 
directory. Xccxic then displays the project window slKiwn in 
Figure 5. CFve opened some of the disclosure triangles to reveal 
the contents of each group.) 



Figure 5: The KitEez project window 


The ‘^Prcx.luct'’ — tliat Is, our application —^ Is shown in rcxl 
lx"cau.se ii hasn't lieen built yet. We can build the application by 
selecting Build (Command-B) frtjm the Build menu. And we can 
run the application by selecting Run (Command-R). If we do 
that, we’l! see the document window shown in Figure 6, 

Magazine 
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price. And, it's RiSK FREE! 



Figure 6: The default document window 

Tlwt's fcriainly not whiil wo wanl; romeml'Kr, wo warn to display 
QuickTime movies in tliis window, not a short text string. 

Modifying the Document 
Window Appearance 

Let's open My Document, nib with Interface Builder, We can 
do this by doubleclicking the entry in the project window. 
Figure 7 shows the main window for this nib file. 



Figure 7: The document nib file 


Now let’s remove the text from the main documem 
window and replace It with a QTMovieVlew objeeu By 
default, the QTKit palette item is not automatically loaded 
into the Falettes toolbar, so we need to choose 
Preferences*.*" and then select the Palettes pane; click 
“Add.*." (Figure 8). 
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Figure 8: The Palettes pane 


Nnvigare to /Developer/Extras/Palettes and select the 
QTKit.palette item, as shown in Figure 9. 
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Drag the QuickTime icon Irrsm the palette into ilie document 
window and resize it to fill die content area of tJie window, as 
shown in Figure 11, In the Size pane of the QT Movie View 
Inspeaor palette, ,set the movie view autasizing so that the 
movie view remains pegged to the size of the window. 



Figure 11; The revised document window 

Now, we need a w;iy for our custom dcKrument class 
(MyDocument) to keep track of iliis new object that weVe 
added to the dcKumenl window. We do tliis by adding an outlet 
to the document class, An oufier is essentially just an instance 
variable that holds a reference to some object. Well add the 
instance variable to our class declamtion in a moment, but we 
also need to add it to our nib file. Click on the Classes tab in the 
MyDocument.nih window and navigate to the My Document 
class, as sliown in Figure 12, 


Figure 9: The QTKit palette 


At ibis poini, the Palettes toolbar looks like the one in 
Figure 10, 



Figure 10: The QTKit palette in the toolbar 



Figure 12; The Class hierarchy window 
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Now .select the “Add Outlet to MyDcxtiment'' menu item in the 
Classes menu. Interface Builder will display the Class Info 
window shown in Figure 13 . 



Figure 1S: The Class Info window 

Change tite default outlet name "‘myOutlet" to “movieViewc 
Sc^ far, weVe created a new outlet For the dcxiiment class. 
Now we need to link the outlet with the movie view that we added 
CO tlie document window. Click on tiie Instances tab in tJie 
MyDcxaJment.nib window; then hold down the Control key, click 
on the File's Owner icxm, and drag until the cuisor is over the 
movie view in tlie documetit window. Wlicn we lelease tlie motusc 
button, Interface Builder displays the window shown iti Figure 14. 
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Figure T 4: Connections of the File's Owner 

Click tlie Connect button tt> make the desired eonneetion. 
Notice that the Destination field updates to indicate that 
movie View is connected to an object of type QT Movie View. For 
the moment, we are done modirying the nil> file. Let’s save our 
work and quit Interface Builder. 

Configuring the Application 

Move Irack to Xcode. The first thing we need to do is add tlie 
Q'l'Kil fnimework to the projeci. Select “Add to Project...” in the 
Projeci menu and then navigate to /System/Llbrary/Frameworks; 
select QTKit.framework and click OK and then Add. 

At this point, we need to add an instance variable for the 
movieView outlet we created in Interface Builder. Open the file 
My Document, h and add a movie View instance variable. Let’s 
also add an instance variable to keep tmek of the QTMovie 
object associated with the movie view. (This is not strictly 
necessary, as we can always get the QTMovie object associated 
with a QTMovie View object by calling its movie method.) Also, 
import the QTKit.h header file from the Ql'Kit framework. 
My Document. h now looks like this: 

#iiii po ct < Q't'Kl t / QTKi t . h > 

©interface MyDocitment : NSDocument 
( 

QTMovieView *movieView; 

QTMovie *movie; 

) 

©end 
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Now select the KitKez target in the project window and 
bring up the iaspc-ctor window by selecting ^'Gei Info” in the 
File menu. In the Properties pane, set the documenl types fur 
the My Document class to include the extension and 

the OS type “MooV”, This witl allow files with names ending 
in '*.mov” or of file type “MooV” to appear in the file-opening 
dialog box. (Liter well see how to modify KiiEez to allow 
the user to select nny kind of file openable by QuickTime. 
regardle.ss of filename extension or file type.) 

Opening Movie Files 

When the user .selects a file in the file-opening dialog 
box. our multi-document application crcales a new 
document window, based on the information in the nib file. 
When il has loaded the nib and initialized all the objects 
specified therein, it calls our document's 
windOwControllerDid Load Nib method. This is where we 
want to assign the movie ro the movie view. 

By the Lime windowControllerDidLoadNib is 0110(1, an 
instance of the My Document class has already been created. 
All the instance variables associated with outlets, and in 
particular mo vie View, are already set up for us. It remains 
only for us to do any final configuration of the movie or view 
before the new document window is displayed to the user. 

As you know, we need to create a QTMovie object and 
assign it to the movie view. Once again well u.se the 
initWithFiie:error: method, which initialises a movie object 
with a QuickTime movie specified by a filename: 

movie “ [[QTMovie alloc] initWithFile^[seif filenamej 
error:nil]: 


We'll SCI the movie asMx:ialed with the movie view like this: 
1 movie View setMovteimoviel; 

And we’ll set the movie to be editable, just like we did 
earlier using setAtlributeiforKeyi 

Setting the Window Size 

Ik'forc sliuwing the new window to the user, w^e need to 
set the size of tlic window’s content region U) exactly enclo,se 
the movie at its natural size. We can deteniiine the natural size 
of the movie like this: 

size ^ [[movie 

attribitteForXey:QTHovleNaturaiSizeAttribute] sizeValuel: 

As you am see, we gel a movie auribute by calling the 
altributeForKey: method. 

We can determine the appropriate content region size 
for a given movie size using the 
wlndowContentSizeForMovieSize: method defined in 
Listing 2. Notice that we use the isControllerVisible method 
on QTMovieView to see whether the controller bar is 
showing; if it is, we need to increase the height of the 
window by the height of the movie controller bar 


Listing 2: Finding a content region size for a 
movie size 

{NSSize)windowConteiitSiz^Fqj:li0vleSizer (NSSize^size 

1 

NSSize contentSize " size: 

if (IiflqvieView isControllerVisiblel) 

contentSlze,height -b= ImovieViow controllerBarHeightJ: 

if (contentSize.width =0) 

contentSize.width ^ UmovieView window] 
frame].size.width: 

return contentSlze: 

Notice also tliai we Icxjk to see whether ihe size pas.sed in 
has a width of 0; if it does, we set the width of the window’s 
content region to the current witlih of the window. 

In WindowControllerDidLoadNib, well call 
WlndowContentSizeForMovieSize: and set the size of ilie 
movie window like this: 

[ [movieView wiudowj sqtCorvtentSize : I seif 
windowContentSizeForMovieSizetsize]]: 

There i.s one final task that we need to perform. Since our 
movie view entirely fills ilie content region of the dtx.’unient 
window, we need to disable tile resize box provided by 
NSWindow and enable the resize box displayed by 
QTMovieView. We can do that with tw() calls to 
setShowsResizelndicator;: 

UmovieView window] setShowsResizelndicator:HOl: 
faovleView setShowsResizelndicator:YES]: 

Listing 5 shows our complete implementation of 

WindowControllerDidLoadNib. 

Listing 3: Opening a movie window 

- (void)WindowControllerDidLoadNib;(NSWindowController *) 
aController 

I 

[super windowControllorOjdLoadNibiaController]: 

If ([self fUeName]) ( 

movie = [[QTMovie sllor] initWithFile:[self fiieName] 
errorrnill: 

if (movie) I 

// set the view's movie 
[movieView £etMovle:movi 0 ]j 

il make the movie editable 

[movie setAttributot [NSNtimber numberWithBool: YES] 
forKey:QTMovieEditabieAttribute]: 

// set the size of the movie window to exactly 
enclose the movie at its natural size 
NSSize size “ [[movie 

att ributeFo rKey:QTMovicNa raISizoAt t ribut e] slzeVa1uc]: 

[[movieView window] setContencSize:[self 
windowCon t e nt Siz eFo r Mo vie Size:sizeJ J; 

// use the QTKit's resize indicator, not NSWindow's 
llmovieView window] setShowsResizelndicator:NO]: 
[movieView setShowsResizelndicator:YES]; 

1 

I 

] 
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IT we ixiild and run the application, we will be able to open 
and display QuickT'ime movies. The movies are fully editalile, eiilicr 
using items in the Edit menij or llidr a>minimd-^ey equivalents. 

Setting Openable Document Types 

'ITie current limitation on KitEez Is that it can open only files 
whose filename extension is “.mov” or that are of I IE'S file type 
“Mo<W. We'd really like it to be able to open any kind of file 
the Quickl'ime can open. We could of course add more and 
more file extensions and types to the application's property list; 
a better solution, however, is to detennine dynamically what 
files should appear in the file-opening dialog box. To do that, 
we need to add an application delegate to the project. That 
delegate will override the openDocument: and 
panelishouldShowFilename: methods, in particular, well add 
the override method shown in IJ.sting 4. 

Listing 4: Specifying openable d<K:umeiit 
types 

- (BOOL) panel; (id3sender shouldShowFilenawe: (tlSString 
’)fllename 
( 

BOOL isDir - MO: 

[ [MSFileManager defauItManngei;] 
fileExistsAtPathifilename isDirectoc^iMsDirJ : 

return l&nir 7 YES ; tOTMovle canIMtMithFile;filename] : 

I 

'Ihe key element here is to ase the QTMovie class iiicilKxi 
canInitWithFile:, which reiums a value of type BOOL tliai indicates 
whetlicT the s[xx.ified file can lx; used to initialize a QTMovie 
olijeci. QTMovie alstj supplies the class methods canlnitWithURLt, 
canlnrtWithPasteboard:, and canlnitWithDataReference:, 

Conclusion 


Effortlessly edit your PDFs 



PDFpen 


Now you can fill out and save forms, 
split, combine, search and even 
scribble on your PDFs with ease! 

"4 mice"-Macworld 


$49.95 - download free demo at FDFpen.com 
4/50 available: POFpenPro for creating fillable forms 


In this artit lLS we've taken a pa.‘liminary first lcK)k ai the 
QTKit framework intrtxluced in QuickTime 7 on Ixith llger and 
Panther. WeVe seen how la u.se QTKit to l^uild a simple 
command-line uk)I tljai manipulates QuickTime movies, and 
weVe seen how to create a multi-document Ccxtia application that 
c'an open and display Quick'l'ime movies. In the next two anicles, 
we'fl continue investigating tliis impoitant new rramework. We'll 
finish KitEez [)y allowing il to save edited movies, and well spend 
some time looking at moie of the Gipabililies ottered by QTKit. 

h\\\ 
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Tiger Time 


For this spodal Ti^^cr isKuc, il seems 
^ppropriute to pass on a few tips that may 
help as you move your development efforts 
to Mac OS X 10.4. 

All-In-One 

Xcode 2 has several nifty new features, 
[)ui our absolute favoiite is "All-ln-One 
Layout." In previous versions of Xcode» if 
you liad a few projects open and each 
project Itad a build panel, a run log. a 
debugger [XtncI, and an editor window, you 
were quickly lost in a sea of windows. In 
Xcfxle 2, all of these functions am lx: done 
in a single window. To experience tlie pure 
joy of All-In-One, you must close all your 
projeers and open the General Preferences: 




Xcode Preferences 

Lil 


\ 


Central 

< -— 

Code Sense 

Bmiding 

— 

Distributed Buildl; 


Editing: 

0 Op«n cou 
QAMtofnati 

Envfronm^rtt: 
M Automati 
^ Autom^ti 
5! Save wiftc 


Layout: f Alt-ln-Qne _Kj 


This firovfdcs virtually all ofKEations 
a single wntfowp such is editing ^lei 
and project comenL hherEng ih the detail 
view, viewing the build results and liutid log, 
and debuggiog. 


Figure 1. 


Wlien you open a project, there will be a segmented 
controller labeled Page on the left end of ihe toollrarr 


0 O M MvE>ocumeni.m ^Trains 

; [‘g^iV~rj ^y^Tfaini i 


# a 


Paae Act^i 

Crdups & Filti 

^ Tme.h 
« Trip.ro 
jV WyOotLirnem.H 
MyDocumertt.m 
^ tJriVCr.h 
jfc. tJr.vtr.m 
i Cny.h 
_M ClUf-ffl 
Cifjwiing h 


Sulid Butid tPid Co 


I owgM-l Pfc^rrftd 


F+lt Naroe 
. WyDOCuroenf.rtn 


^ *■ [i^MrDPCiynierit.nni lS ; a@mpleni«ntatlafl My 

^import "MyDocumerit. h" 

#impo r t "Rout eView.h" 


@iiTrpleinentcition MyDocuinent 


Figure 2, 


1 herc are three pages: 

The editor page handles editing, project search, and 
revision management. 

The hiiild page handle.s the [>uilding, the build log, and 
the run log. 

Tlie debug page handles debugging. 

If you often work with several projects simultaneously, tliis 
will make your life a much more pleasant place. 

Backwards Compatibility 

If only users would update immediately to Tiger, we would 
not have to wtyrry about i>ackwards compatibility. The most 
common source of backwards compatibility issues is inadvertent 
use of new Tiger APIs. This will prevent your application from 
ninning on 10.3. There are two good solutitms to the probleiiL 

Solution 1: Use the 10.3 SDK (or 10.2 if needed) for apps 
that should only use Panther APIs. 
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^ O PrOKa ^tXttra* Info 



Change IDK Rooi Directory 

Oiafigjng your pfOj«£t*i SDK root diroctoiy will tous« 
vour proiea to build agam^t a different set of system 
headers and libraries than before. This could 
signihcmdy affect the build and/or runtime behavior 
of your (Koject, Are sure you want to change 
mis setting? 


( Change ) Cancer") 

Wume^ ' /ito/Uietsfr l bs/ProMs 

Place intermediate Buttd rtles In: 

@ Default iniermedUwes location 
O Build products location 
C Custom location 

/ voTume s / aco /Use rs f* n lbs / Project s / B uiki 


Cross*Develop Using Target SDK: Mac<SXl0.3.9 f) 

Choose. .Q 

_ Ena!:I? sew SCM System- None 


Figure 3 . 


and stft the "Mac OS X Deploymenc Target" in the 
taigei build sellings to 103: 



Figure 5. 


Tliis will cause the application to link against stub libraries 
thai match the APIs available on 103- 

Solution 2 (our favorite): Use the "Current Mac OS" SDK io 
take advantage of all the latest APIs on the current system: 


Tliis causes the newer Al^Is to be weak-linked into 
the applicaiion. It reejuires a little additional work by the 
developer to check the availalnlily of an API in the code 
and gracefully handle cases where API is missing (running 
on an earlier version of the OS). 

C function symbols need U> l?e checked if their 


O _ Pr^jt a >Xitra* Info 



Change SDK Roat Directory 

Changing your project*! SDK root directory will cause 
your projea to build against a different set of system 
headers aod libraries than before. This could 
slgnihcandy affect the build and/or runtime behavior 
of your project Are you sore you want to change 
this setting? 


( Change ) Cancel - ^ 


Place Nitermediaie Build Flies In: 

® Default Intermediates Jocarion 
O Build products location 

C Custom location ^ Choose. ; 


i Voiumcs/aco/Osers/ntbs /Projeas /Build 


Cro$s-D«v«lop Uiirvg Target SDK: Current Mac OS ) 


(^Choose...) 

_ Enable SCM SCM System: None 

-TT) ■ 


value is valid: 


If [GGContexiFillEllipsernltect 1“ NULL) 

1 

CGContextFillElllpselnRoct(context, rect)i 
1 else i 

// Older OS version actions 

) 


Objective-C methods can l^e detected using - 
[NSObjeci. respondsToSelmor:! 


If ([tableview 

r e spondsXo S e le c to r:@s e lec to r( setC olunmAuto r esiz1n gS t yle)] 

[ 

[tableView 

setColumiAutoresizitigStyle:NSTableVlewLaetColumnOnlyAutor 
eslzlngStyle]: 

1 else 1 

// Older OS version actions 

I 


This is die most powerful solution ils ti allows the 
developer to take advantage of the latest features wtiile 
maintaining the broadest compatibility. 
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Set: Applets docymentation on cross development for more 
details: 


http:y/developer.apple.com/documenianon/DevelopeTTools/Conceptual/cro 5 S_cl 

evelopment/index.html 


“Is, 

• Website Not Found By Clients 
M HTTP 404 - Website not found 


Debugging Bindings 

lliere liave l>?en many a)mplaints that bindings are difficult to 
deUig. This Ls Siidly still Ime, but Apple Im lx:gun to make things 
easier for us, Tliere is now a defeiilt NSBindingDebugLogUvel. Set 
it to I to aim on logging. The easiest way ts to pass it as an 
aigument on the command-line. Under tile Executables group in 
XaxJe, select your application, and look at the info pimel. Add the 
argument -NSBindingDetxjgLogLevel 1, 



In the slum tune that we have been using Tiger, we have 
found it to l:»e a superior platform for developers, li is clux'k- 
liill of fun new technologies and is even more iK^auiiful than 
10 . 3 . Enjoy! 

'/ill 
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The website you are looking for can't be found 
by your clients. It may have been improperly 
marketed, had poor design, or didn't work. 
Regardless, it's not helping your business! 

Your Options: 

• Rent a chicken suit and stand on the 
corner handing out flyers 

• Paint the company URL on your chest and 
face during a major sporting event 

• Contact SharpNET Solutions internet 
marketing and web design specialists, 
watch your traffic and rankings increase, 
get great feedback from all your 

new customers. 

HTTP 404 - Website needs SharpNET 
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Not Marketing Your Site? 

If you are not marketing your 
website online, you may as well 
have a 404 error for a website. 
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Complete Soune Control ^Seapine Software™ 

m Ufimd 

uf Moftware dei^topment 

and Oefett Management 

for Mat OS X 



Effective source code control and defect tracking require powerful, 
flexible, and easy-to-use tools—Surround SCM and TestTrack Pro 


• Complete source code control with private 
workspaces,automatic merging, rote-based 
security, and more 

• Comprehensive defect management — track 
bug reports and change requests, define 
workflow, customize fields 

• Fast and secure remote access to your source 
files and defects — work from anywhere 

■ Advanced branching simplifies managing 
multiple versions of your products 


■ Link code changes with defects and change 
requests — know who changed what, when, 
and why 

• Scalable and reliable cross-platform, 
client/server solutions support Mac OS X, 
Windows,Linux,and Solaris 

■ Exchange data using XML and ODBC, extend 
and automate with SOAP support 

■ Licenses priced to fit your budget 


Seapine Software Product Lifecycle Management 
Award winning, easy-to-use software development tools 
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nent 


dII product narnes lisfod tim aie tiodoniQrb d itioir rsspKiive awiters, All ngtits leservsd. 


Download Surround SCM 
and TestTrack Pro at 
www,seapine.com 
or call 1-888-683-6456 





































Business Card 
Composer 


Tliis piece of software is really, really 
cool. You^re thinkin^^, big deal, biz card 
whatever No. The folks at BeUght Software 
have really come up with a simple to u,se, hut 
incredibly deep program ihal gives you all 
kinds of abilily to create business cards* 

Business Card Composer (BCC) is 
surprisingly intuitive to 
use. Written in Cocoa, ii 
provides you wiilt 
multiple ways to make 
Ixjsiness and perstjnal 
cards as gtxxl ltK)kmg as 
you can make tliem. 
perhaps even a bit 
l:)etter. BCC can either 
walk ycHi ihniugli the 
process with it’s 
Assistant, giving you 
access to over 130 
preset designs, tfutt you 
can alter to your caste, 
the prognim will walk 
you through tlie piocess 
of creating a card* It's a really great priti^r to get 
you used to working in tlie application's 
environment. Once comfortable with ilte 
interface, you are ready to ait kxsse* 

Ttiere are a ton of leatum-s packed into the 
little app. The screen presents you with a oard 
repre.senUitian that you can add to and 
manipulate in multiple ways, BCC lias a pletliora 
of images, and backgrounds you can add to your 
card (alxjut 500). You also C'an import your own 
images, or search Google from within the 
program for what you're k Hiking (or. Any font on 
your .system is available to you, obviously. You 


also have tile ability to apply over 50 masks, 
sliadows, and control opadiy. 

BCC integrates witli Address Book, as well 
Say you need to generate cards for multiple 
people in your oiganization* Once you've created 
the card everyone will u.se, just drag their name 
fomi Address Bcxik into BCC, and the program 
wiU automatically 
pcipukiic die card with 
die new information. 

Once you have 
your masier|>iece of 
business introduction 
ready to go, you have 
options for output. You 
can exfxjrt 10 either a 
tiff or PDF file to .send 
to a printer. You also 
have the option to print 
your own, BCC includes 
page setups for just 
about every available 
paper out here* 
Personally, I am fond of 
the Avery 28877 card stex'k. It's really gocxl 
heavy stock, that breaks apart with no 
pertbmtions tin the edges, 'llie really nice bit 
here is you do not liave to worry aixiut getting 
tile cards aligned for printing, just hit command- 
P, and BCC takes care of the rest. 

So, this program wiU help ycju create 
professional quality business cards rigltt from your 
home system* Yeah, this piox^ of software is really, 
really cool It's alst> useful* A l>aigain at $39,95, 
$48.95 ft>r a CD. You can try it out by downlmding 
the demo from BeLight's web site at 
\^ww.belightsf.)ft*a)m. - Mkbae! R. Hanley 
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KoolToois 


DeskMount G5 



Marathon Compulcr ,sold what is still probably one 
of the most useful accessories for the G4 tower. Il was 
a two piece system* One piece attached to ilie 
underside of your desk, and other replaced the top two 
handles of your tower. Tlie two pieces IcK'ked together, 
and held the computer up off the floor. It was a great 
part. My only complaint was It was too long, and you 
needed to be sure your desk was deep enough to hold 
the thing. 41ien came the 05, 

Willi it's new form factor, the G5 tower made 
the DeskMount unusable. The design engineers at 
Marathon were undeterred, however They quickly 
redesigned the DeskMount, turning it into a single 


piece that the G5 handles hang from underneath the 
desk. Unfonunaiely, this thing requires an even 
deeper desk to mount it under. I'his time, it's not 
Marathon's fault. The G5 itself is such a large 
computer tower, that they had to make the 
DeskMouni G5 longer. AS with the original, though, 
it is well worth it. Keeping your tower up off the 
floor keeps it cleaner, keeps it form sucking as much 
dust, and gunbk, and who knows what into the it, 
keeping the computer cleaner. It allows you to more 
easily keep a handle on cable clutter, and protects 
the machine from accidental fender benders* 
Definitely worth $59- 
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Skin 

Tight 

Armbands 

There are a myriad of ways to carry around, and 
pnHecL, your iPod. Speck Products has come up 
with another addition to their line up of il\)d eases 
that takes care of ihc fitness set among us. The Skin 
Tight Arnihand. 

The Armband is available for 4G, 3G, and mini 
iPods. In essence; the Armband is a clear plastic 
brac'ket attached to a wide neoprene strap with 
Velcro dots on it for .securing around your arm. Tlie 
clear bracket has a cable management clip on each 
side of the clij). With yt>y can keep excess ear bud 
wire from Hopping around. IPs a nice touch. The 
band itself is very comfortable. It is big enougli, with 
enougli Velcro dots on it, to fit handily around most 
any arm size. 

One of the very’ neat features of the Skin Tight 
Armband is that it has one of Speck's iPod Skins 
included. In fact, the bracket is designed to l>esr hold 
your iPod with the Skin on. The skin itself is a 
translucent, nibberized niutertal that gives your iPod 
an extra layer of protection. It acts as a kind of shock 
absorlier, plus keeping the iPod from getting 
.scratched. It lcx>ks nice, too. 

I'he effect of all this stuff is to keep your hands 
free while walking, running, biking, weight lifting, 
whatever exercise you do. It is unobtrusive, and does 
a nice job of keeping your music in yt>ur ears, and 
out of your way. Direct from Speck Product's web 
site for $34.95 for the 3G and 4G iPods, $29.93 for 
the Arm Band for the iPod Mini. — Michael /?. Hanley 


Pro Pack 

FOR 

GarageBand 

Zero-G is a UK based company that specializes in 
producing sound samples for tlie professional audio 
tuarket. 'ITiey make a \ui tjf them, and they do it w'ell. 'fhe 
Pro Pack for GarageBand is their first foray into the 
consumer space. It's quite a way to dip your Uxi into tlie 
water to see how it ftfels. 

The Pro Pack fur GarageBand contains 11,191 Icxjps 
drawn from Zero-G's massive collection of .samples. It is 
compatible not only wath GarageBand, but also 
SoundTrack, logic Pro 7, Logic Express, I'inal Cut Pro, or 
any application that can use AlPF files. It lakes two DVD 
discs to hold it all Instailing into GarageBand is as easy 
as dragging and dropping the disc icon onto the loops 
window of GarageBand. Be prepared to wait after that, 
though. It will take time for GarageBand to load 
eveiything into the program, and index it. Once iPs all in, 
though, you will have at your finger tips .seemingly 
unlimited new' w'ays to create music. 

'Ihe loops in this package cover the gamut. Etlmic, to 
jazz, to rock anti pt?p. One liundred seventy one lead 
guitar rifl^. Midget gems? Whatever they, are iliey are 
there are 2,079 of them, lots of really cool vocals, even. 
About 1200 of them, in fact. World, African, and Indian 
themes. All die UK)ps are of really gcxxl cjuality. Every’ 
loop lias the letters ZG in the name, making it eitsicr to 
tint I the loops from the Pro Pack. 

Apple includes a really gotxl collection of sounds 
with GarageBand right out of the box. However, if you 
find that you've done all you can w'itli Apple’s stuff, or 
simply want mc^re options, die Pn> Pack for GarageBand 
is well w'f)rth getting. It w'ilJ open up whole new horizons 
for your musical muse. It is available directly from Zero- 
G for $169‘95. - MichaiH R. HanJiy 
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!i. 


Digital 

Satellite 

O’Sullivan lnduf>irit‘?i, Inc. has been making desks 
for quite some time now. They’ve gotten veiy good at 
providing a myriad of styles to fit varying tastes and 
needs. They iiave, this time, come up with a very 
interesting gadget to compliment your desk. The 
Digital Satellite puts a collection of pons eveiyone 
needs to get to often right on the desk, while dropping 
the corresponding attachments to compute^ power, 
etc. under the desk, and out of the w^ay. 

tn order to properly install the Digital Satellite, 
you 11 need to drill a 60 mm hole into your desk. So, if 
you have glass or metal, this could prove tiicky to 
impossible. However, once you have the hole taken 
care of, the Satcllile drops in, and clicks into place, 
holding securely watli retainer cliiss (the clips can also 
be held in so removal is easy ), i’he next step is to plug 
all the various biLs from the underside to their correct 
ports in the computer and wall. This ought to be the 
last time you’ll need to make a trip under the desk to 
hook stuff up, at least for a w^hile. 

Silling on Cop of the desk now is a round bump. 
I’hat bump gives you two power outlets, phone and 
Ethernet connections, as well as a USB 2.0 hub. The 
USB hub portion has four 6-pin poits, and one ^-pin 
upstream port. The hub is powered, While the powder 
outlets are not surge protected, they do have a circuit 
breaker to fprotect from serious overloads. Tlie tjne 
omission is no FireWire. With everyone and his 
grandmother using digital video, ifs a must. 

The ideal use for this device is in an office 
environment where you have mobile users coming in 
often who need to plug in and get to work. Setting this 
up on availat>le desks for these kinds of users w^ill save 
them, and IT support personnel, a lot of time rooting 
around underneath desks, and keeping cable clutter 
on top of the desk to a minimum. The Digital Satellite 
is available from O’Suliivan on many of tlieir desks, 
and can also be purchased sepamtely for $49.98. - 
Michael R. Harvey 


PostWorx 

Speedball 

It used to be that laptop computers had the ability 
built-in to raise up at an angle to make typing easier. Not 
so anymore (the FowerBook 5300 being the last model 
with dial ability, along with the ability to spontaneously 
combust). The Occupational Safety and Health 
Administration (OSHA), a part of the U.S. Department of 
Labor, has dec reed that keyboard risers cause the user to 
put his or her imnds at an angle that is damaging to die 
wrists. Many users still find that having the keyboard at a 
slight angle is far more cf^mfortable than it laying flat Tn 
steps PostWorx (wvvw.pOstworx.com) with a scdutic^n. 

The Speedball is a set of half spheres designed to 
raise the back of yew laptop up. The back is raised to an 
B degree angle, which PostWorx says is more 
ergonomically sound than the keyboard laying flat 
(although OSHA disagrees). Two small friction pads are 
included to attach to the front comers if needed. The 
unique thing about the Speedballs is that they allow you 
to easily slide your laptop along almost any surface. 
Moving your laptop to show tlie screen m someone sitting 
opposite you is as easy as sliding the computer around on 
the speedbaUs. lliey are very low' friction, liaising up your 
laptop has one definite advantage. You get hetler air flow 
underneath the computer, and less heat build up witli the 
Speedball installed. 

The Speedballs come in colors to match both the 
wliite iBooks, and Titanium PowerBooks. They also come 
in a style that permanently sticks to the bottom of your 
lapR)p, and one that can be snapped on and off. We 
recommend die snap off variety, as perrnanendy atLaching 
tliem [nakes a laptop a bit difficult to get into most laptop 
cases. Tight fining sleeves cannot fit over the Speedballs 
at all. 

The Speedball Is sold through several retailers. Check 
their web site to see who caoies it. - Michael R. IJarv^^ 
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ScreensavRZ 



One problem mos^t Apple laptop ctimputers have 
these clays is that with such tight tolerances inherent in 
trying to minimize the thickness of the systems^ keyboards 
and screens often make contact when the lid is closed> 
Din and gtink can and does transfer from the keys to the 
LCD screen. Abrasions from the contact of keyboard and 
screen can also be a f>roblem, reducing tiie Liseful life of 
the screen, as well as just niakijig the desktop hard to see. 
Getting that dirt off rlie screen, keeping it off, and 
preventing the keys from abrading tlie LCD is a problem 
that RadTecIi (wwwaadtech.us) has a fix for. 

The ScreensavRZ is piece of fabric designed to clean 
the screen of your laptop, and hel p keep it tliat way. The 
fabric is an ultra-micro fiber called Optex, Optex was 
specifically designed for polishing plastic optics* As it is a 


non-woven fabric, it can be cut to fit, and will nor fray. 
The package includes the la brie, and some easy to follow 
instrucLkms. That is all you need to get your screen clear 
again. And, once that is done, just be sure lay the 
ScreensavRZ over the keyi>oard before closing the lid to 
ensure yejur screen remains dean. 

The ScreensavRZ is available in Aqua Blue, 
'ritanium, or Graphite. A "Shagwire"’ pattern is also 
available. Emblems, or logos are available on the aqua 
and graphite versions. RadTech has the option to have 
one of their standard logos imprinted on any but the 
Shagwire patterned cloth. Price ranges from $13-95 to 
$17.93. They can also do custom emblazoning of your 
text or logos. Contact Had'l'ech for details and pricing. “ 
Michael K. Harvey 
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Tron 2.0 


WIicn T first ficard a he nil Tron 2.0, I was excited. I 
was excited mainly because I luid heard il was ^oing to 
be a movie. I here were link.s to tantalizing web sites that 
teased you like no movie trailer could. I was all kinds of 
w'orked up over il. When ihc video game wais finally 
released, i was disappointed, to say the least. Then, I had 
the chance to actually play the game. Veiy nice! In case 
you havenH guessed, and in the interesl.s of full 
disclosure, I am a ridiculously huge fanboy when it 
comes to Tron, 1 owm the video (it's w^orn down to almost 
unplayable). 1 owm ihe DVD (which, hy the wiiy, has 
some of the coolest audio coimnentaries youll ever come 
across). I've played the games. If 1 could swing it, Td 
have one of the full sized arcade games in my living 
room. Up at Big Dear Lake, CA, there is an arcade tliat 
has one. If it's working, and 1 am there, I'm playing it (it's 
not like the bar isn't right across the street anyw^ay). So, 
rest assured that my review' wdll be totally and completely 
unbiased <snark>. Really, though, this game is a real kick 
in the pants, especially if you are at all a fan of the 


orginal 'Iron movie. I mean, come on, wlio woiildifl 
wami to kick the stuffing out of the MCF, or ride a light 
cycle (although you'll need a lOOBa.scT connection to 
ride with others on a network)? Even if you aren't, the 
game is enjoyable. It plays like a standard first person 
shooter (there’s not)ting lerdhly special abotil the play 
wlien compared to other shooters in the genre), but the 
story that drives it is very entertaining, drawing you 
along. Add to that great graphics and sound, a good 
story, lots of stuff to destroy, and Bruce BoxleiLncr 
lending his voice to the Iron universe once again in his 
role of Alan I. What could be better? The system 
requirements are surjmsingly modest, considering litw 
good the game looks. Mac OS X 10.2.8, 700 Mllz G4 
Procccssor, 256MB RA^f, and a 32MB Radeon 7500/ 
GeForce 2MX or bettcT video card. The game is available 
directly from MacFlay for $49.99, about typical for a first 
mn game, and definitely woith it, especially if you 
gecked out wlien waldiing the mtwie for the first time as 
a kid. - Micbaei R. Hawey 



From our brain to your brain... 

SpiderWorks eBooks 




For more information and to order online^ visit 
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ACLs: Finer Grained 
Permissions (and more !) 

Zero In On Exactly What You Want. 


Introduction 

Back in tlie Deccjnl>ci- MacTt^ch, I 
wrote an anide introducing the Unix 
POSIX permis.'>ion system that Apple 
kept in place from Darwin’s BSD roots. 
That system has been around for 
decades, and modern .systems are fully 
aware of its iimilations, 

Apple has l:>een making great strides 
with each release of OS X. Additionally, 
theyVe realized that they doni have to 
strictly slick vviili what tlieyVe l:)een 
handed in Unix-land, and can make 
improvements where neces.sary. Now 
that w^e all know', and should be 
conifoitable with Unix (KOSIX) 
permissions, it's time to learn ACLs: a 
more flexible way to assign jx^rmissions* 

Slowdraw 

While ACLs are new to Tiger, some 
of us have been using ACLs for years. 
DicI we liave .scime secrei l>eta of 
Panther that included them? Nojx?. 
The reality Ls that just alxjul every other 
major operating system has had some 
tbrm of ACLs built in for a long lime* 
There’s a patch for most Linux distros 
that enable ACLs. Netware and Banyan 
had it over 15 years ago. And certainly, 
Windows has had this permissions 
model from the N'P days. Windows? 


Yep, While there are security problems with Windows, I 
haven't ever heard of ACLs having or causing a problem 
(unless, of ctjurse, the administrator mis-applied them). In 
fact, in 'figer, Apple has chosen tlie Window.^ ACL mtxlel. 
Make your head spin? Naahhh. OS X is a new world, and 
recognizes that it also lives in one, wiiere it needs to reach 
out in as many ways as possil:>le* 

in this articJe, 'ACL' refers to file system ACLs. Tiger 
also introduce,s Service ACLs, or, SACL. This allows you 
to limit services (like AFP or ftp) to particular groups and 
users. SACLs will be touched on next month. 

Enough chatter, on to the gtKxl stufL 

GotXAttr? 

For some background, it's helpful to understand 
metadata. Metadata, for the uninitiated, is all of tlic 
information about a file that’s noi aciually part of tlie file 
data itself (dcfKmding on implementation, it may or may 
not be a physical part of the file. MP3 files store metadata 
as pan of the file itself, ft^r insutm^e.)* We saw Lliis l>ack in 
OS 9 in the fomi of lyfx.* and creator ctxJes, Last update 
lime is also sometlung ikit the file system tnicks, but doesn't 
effect, and can change independently of, the data in die file. 

Here’s what’s sr> revolutionary (t)k, evolutionary - but 
revolutionary sounded lietter) alxiut what’s happening 
under die hood: OS X 10.4 has room for even more 
metadata. This comes in the fonn of arbitrary data, and file 
system altribules, like ACLs. Much like ACLs themselves, 
other operating systems have enjoyed the increased abilities 
of arbitrary file system metaebtm for much longer now\ 
Anyone who ever liad a cliance to play witli BeOS will 
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Ta J iger, OS X 10.4 is here! Apple touts a grand list of new 
I features and iniprovements to our favorite OS. One option 
I that may go un-noticed if you’re not looking at Server is ACLs. 
‘ACL’ stands for Access Control List, and is an enhanced way to 
specify permissions on file system objects. What you won’t see on 
Apple’s pages is tliat ACLs work the same in both Server and client. 


rememloer what I mean - one could almost treat die file 
system as a large databa.se, assign keywords to your files, 
and simply setirdi for those keys later on. Similar to what 
SjX)tIight is doing on the Mac. As a musician, tliis was 
revolutionaiy. (1 was planning at the time to use Steinberg's 
Nuendo running on BeOS - in fact, set up an entire studio 
around it. Oh, well). You could add keywords to all of 
your music clips (and iyLP3 hies), and almost liave them 
organize themselves. I expect to see similarities on the Mac 
with audio and video files, and the Finder's 'smart folders'. 

OS X pulls this off by taking advantage of nFS4. See? 
The ability to write metadata was there all along! Well, 
OK, only somewhat recently in HFS+'s evolutitjn did it 
gain this capability. Before Tiger was a reality, cenainly. 
Much like the resource fork is an akernate data stream, 
the extended attributes simply get stored in a stream 
intended for 'inline data'. 

Currently, the ability to rap into this functionality only 
exists at the BSD layer. No interface for CF, Coc:oa, or my 
beloved KEALBasic exists (yet) to call lhe,se functions, 
(Someone wanna get cracking on a KB plug-in for this?), 
OS X Tiger currently has several fLinctions at the BSD 
layer tliat take care of thisS; sctxattr, fsetxattr, getxattn 
fgetxattr, reniovexattr, fremovexattr, listxattr and flistxattr, 
Tlie T variants Lake a file descriptor, as appo.sed to a path 
to determine which file it's working on. Each has a useful 
man page - check them out. 

NavChooseYourPath 

T must really like you, because Vm going to admit 
something, a vulneral^ility, if you will. It’s st^melhing 1 


M/CnCH 


don’t like to own up to, and at times, it simply 
makes me check my geek cred at the door. Here 
goes: My C coding skills stink. I r^sed to be l:)etter. 1 
even used to get paid to write C code. But even 
then, I pretty much realized ] wasn't really great. 
Consequently, I was much more interested in 
networking and databases (somewliaL in graphics, 
too, but guess what? Tm terrible at graphics 
programming, also!). With all of that said, Fm going 
to include some crummy C ct)de here Lo illustrate my 
points about metadata. Please don't write telling me 
how bad I am: 1 know. (However, I'm always up for 
improvemenL and a conslmcLive dialog — don't let 
me down). 

We’re going to do this a little backwards, and 
show some code that reads one extended attribute 
from a file. Tliat code is tliis; 

lijic1ude <CoreFoundation/CorcFoundation.h> 
linctude <sys/xatTr.’h> 

int main {int arge. const ckar ' argvt]) I 

3ize_t size ^ 0x00: 
int options = 0x00; 
char ''theBuffer = 0x00: 
char ^theName ” OxOQ; 
char M.heDflia ” 0x00; 

// Figure out if thclc arc any extended attributes. 

size “ listxattcf“lEyfile.txt”, theBiiffer, aize. 
options); 

if(size > 0x00) [ 

//There aie extended ailribules, let's go feiehl 

theBuffer = calloctltSize}: 

// Get a name of an attribute 

size ” listxatt]:(“iiiyfile.txt“, (void 'JtheBuffer. 
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size, options); 

theName = malloc(sti:ien(tliaBuffer} ): 
strcpyttheName, theBuffer): 

vSize = 0x00; 

// How much data arc wc c-xpecting? 

vSize “ 

getxattr("myfile.txt".theNauie,NULL,vSlze.0x00.0x00): 
theData = manoc(vSize); 

//Associate the name to the value. 

vSize “ 

getxatt r (“myfile. txt, tlieName, theData. vSize. 0x00,0x00): 
printf("%s %s\n‘’.theData); 

1 else { 

printf(“This file has no extended attributes.\n“): 

] 


tetutn 0; 

I 

1 used XCode to btiild tills, and called it ‘‘rx” (Read 
extended). Drop to die coniinand line, go into your build 
directory and create ‘"myfile.txt”: 

echo This is a test > myfile.txt 

Now, run rx; 

S . /rx 

This file has no extended attributes. 


The code to set an attribute is much more simple: 

^include <Cor:eroijndatiori/CoreFoundatiori .h> 
fenclude <syE/xattr.h> 

int main (int argu, const chat * arg,vn) I 
int sxr; 

int options = XAri’R^NOFOLLOW: 
char theValue[5] = “blaG\0''; 
size^t theSize ^ sizeof(theValue); 

ptintf {“Going to eet length the Value. theSize) r 

mr = setxattri"^rayfile,txt"t “color'*, {void *)theValue, 
theSize. 0. options); 

return 0; 

) 

Again, J liuilt this in XCodc, and called it sx (Set 
extended). Once you build it, grab it from your build 
directory, and copy it lo the liuild directory for rx. Run it, 
and it will create an attribute called 'Valor” with a value 
of “blue" on niyfile.txt. Immediately run rx again: 

$ . /rx 

color “ blue 

You'll see that tliis time, we pick up the attribute and 
value associated with this file, (and now that that's over, 
T promise never to shove C code at anyone again). 

Now, all of this metadata is cool, but it's really still in 
the larval stages. Go ahead and change the program to 
make the value more unkfuc, run it, and then try 
searching for tJie value in Spotlight. Til spare you tlie 


work: tliere's no importer for this yet, so Spotlight finds 
squat. The good news is that all of the BSD tools 
understand metadata: c:p copies it, rsync, with the -E 
switch, syncs it. Nice. If you copy a file with metadata 
to a volume that doesn’t support it (*cough* FAT32 
*cough*), youll get files prefixed with a dol-underscore, 
like it would do for a resource fork. 

You have several options to protect these files: zip 
'em, or create a disk image to protect the contents. 
Remember; this is all working on a standard IIPS+ 
volume, and disk images work just fine in chat capacity. 

Again, this is something Windows has supported for 
a while in NTFS. Over there, tliey're called streams. 
Frankly, Fve never seen them used in a practical way tor 
straight data files - and once with malicious intent (read: 
vims samners don’t scan the alternate streams of a 
file,..). However, Services For Mac does store the 
resource fork in a stream. 'ITiat’s useful. Tin incredibly 
interested in seeing how this gets used in the OS X world, 
for good or ill. Although, I don't think this will really 
explode until the higher-Ievel APIs come into existence. 

WaitNextEvent 

Right alzjoiit now, you should be saying, “Tm reading 
this article because 1 ihouglu it would talk about ACLs!" 
OK, no lime like the present! 

If you remember from my December article, or 
anyplace that you’ve read this, OS X supports tlie 
traditional POSIX file permissions. As of Tiger, CSX now 
also supports file .system ACLs. ACLs are a way to assign 
permissions to file system objects in a much more nexil>le 
fashion than before — one might even say an arbitrary 
fashion. Of course, I'm not saying that you don't have to 
plan out a permissions strategy, bni consider this 
scenario; You have a sharepoint called 'Accounting’ that 
stores accounting data (not too much of a stretch, right?). 
Witliin this folder ai-e -sul>fQlders for certain sub-groups 
within the department. However, certain files in each 
group.s’ folder need to h<^ accessible by other groups, but 
of course, not 'everybody'. To accommodate, you set up 
folders for each group, with the correct group (wners 
and permi.ssion.s (770), and several ‘shared’ folders for 
files that cross between groups. Then, you are told that 
Lin outside auditor neecis an account and access only to 
certain files that reside in each of these directories. Using 
just the POSIX permissions, you could do it, but you Ye 
going to jump tlirough a lot of hoops to acc'omplish this, 
and perhaps not really .simcture die hierarchy in a fashion 
you’d like. 

Apple wants you to think of ACLs as a technology for 
OS X Seiver, but like most things that .server dtx;s, tliis 
can be accomplished on standard OS X as well. All 
Server gets you are some good-looking buttons and 
checklx>xes. We’ll discuss botli OS X and OS X Server. 
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The abitity lo use ACLs must tie enabled on a given 
volume. Using Wtirkgroup Manager, you'll find the 
following new checkbox (Figure 1): 


f Ccnerat \ Access Protocols Mctwofk Mounr^ 

5! Share this item and *ts concents 
□ Enable disk quotas on this volume 

Enable Access Controt Lists on this volume 


Figure 1 - Workgroup Manager's new option 

Check it, and click on save. Again, good-looking [>uLLon,s 
- but we can enable diis from the command line on lioili 
client and server by using fsacIciL For example, this w'ill 
enable ACLs on the root volume: 

fsacictl -e -p / 

Use sudo with tllis command U’ youVe not already root 
somehow. Unforrunately, Apple left out the man page fcjr 
Uiis command on OS X (it's there on Server, though). 
Apple dcx^sn'l even have it on-line (at the time of this 
writing). You can get usage simply by typing Isaclcir 
with no parameters, though. ‘Ibe “-e'’ switch tells fsaclctl 
to enable access control lisis, and the “-p” switch tells il 
the mount point to perform that action on. With just the 
“-p’' switch and no action, we can find out the status of 
ACL support on a mount point: 

# fflaclctl 'p / 

Access control llsta are not supported or currently disabled 
on /, 

So. lei*a enable tham: 

jf fsaclctl -e *p / 

# fsaclctl 'p / 

Access controt lists are supported on /. 


Now, how do we tise them? Once again, Workgroup 
Manager (WGM) will let you assign and alter permissions 
through a GUI, and both OS X and Server will let you 
fX-Tfonn these assignments though the command line. 
Each time you make an assignment lo a filesystem object, 
it l>ecomes an entfy^ in the access control list, also known 
as an Access Control Entry, or, ACE. In WGM, check the 
'Access' tab for a sltare, and again you'll see something 
new (Figure 2): 


Ceneral Access ! Protocols Network Mount ^ 


Owner: root ^ Read & Write ^ i | 



Croup: staff 

Reads Write 

JB 

Everyone: 

^ Read & Write 



Access Control List 

Accui coAtn^ l4t cmf«i uki ei*ctd#f>c« M%r iht %iMPAAf4 


\HtT w Croup 

Type 

Emission 

Inherited 

AoNfes To 

nr database 

Allow 

t Read 

: No 

This foldi 

msoff 

Allow 

: Read 

t No 

This fold( 

i Edward R. 

Allow 

1 Read 

1 No 

This fold( 


€:T-:T----Trr-^-rT7— 


Figure 2 - Workgroup Manager's Display of ACEs for a share 
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home, didn t get out very often. 



The cost of keeping servers 
in-house can far exceed the 

Starting at only $130.00 per month, 
Xserve Colocation includes: 

m Cafi in fnr a ‘csi/iinac nf nf\* 





cost of server outsourcing. 


run qg 11111 

That’s where xservHosting comes in. 
With Xserve Colocation services, you 
can afford cost-effective, flexible, and 
highly reliable network and internet 
services, freeing up more of your time 

• rftrfcr aciup lUf a bdVIlIgS UF ^bDU.UU 

• Rackspace and Power 

• 1Mbit connection burstabie to 100 Mbits 
with unlimited data transfer. 



* Please mention code MTM0305. 

^XSH 

^11 XSERVHOSTING 

pozverinx the xserz>e rei»o/Mfion 

Xserve Colocation | Hosting | QuickTime Streaming 


m 

to take care of business. Don't stay 

home managing your servers - call us 
today at 949-480-9701 or visit our 
website at xservhosting.com. 
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You can tiicn p<jp Dfien the users and groups list, drag and 
drop them into the list and assign permissions* Easy. What 
kind of pennissions c'an be assigned? Again, WGM makes 
this relatively easy* Selecting 'custom' from the Permission 
column of an ACE shows you the full list (Figure 3): 


User/Group: Edward k. Marczak 

Permission Type: [ Allow t inherited: No 

Permission 

TQAdmlnisinUon i 

I Q Change ^rmisslons [ 

D Change Owner ! 

▼G Read 

G Attributes 
G Read Extended Attributes 
G List Folder Contents (Read Data) 

G Traverse Folder (Execaie file) 

GRead Permissions 
▼ O Write 

□ Write Anributes 
G Write Extended Attributes 
D Create Files (Write Data) 

G Create Folder lAppend Data) 

G Delete 

C Delete Sub^olders and Files 
T0 Inheritance 

0 Apply to this folder 
@ Apply to child folders 
0 Apply to child files 
@ Apply to all descendartts 

( Cancel } ( 0K- ) 


Figure 3 - Permissions that can be assigned to an 
individual ACE. 

Mow do you know that a file or fc^ldur lia*s an ACL associated 
witli iL^ Of course, you can use WGM and look at the list* 
But WGM only helps us with share poinLs. In tlie example 
1 gave earlier, where you may have a share iwint, and 
several folders l)elow it that need difFereni jiermissions, you 
need to go for the gcx)d stuff: the command line* 

GetKeys 

'iTie CLl is where it's at* The GUI tools are nice, but 
the ccjmmand line w'ill work Icxrally or through ssh, on 
Server and OS X *standard. Ell swing through thi*s quickly, 
and then come back with more detail. 

Apple has updaied ihe familiar utilities to deal witli 
metadata, including ACLs. First and foremost, chmod is 
now responsible for most things ACL: adding ACEs, 
removing ACEs, ordering/changing ACLs and changing 
inheritance. The ''+a” switch tells chmod to add an ACE: 

$ chmod +3 "tBacczak allow soinefile.txt 


Rerncml>er: even if you are ‘deny'ing, youVe still adding 
a Rile to die list, Ls, with it's new “-e'' switch (must be 
combined with "-D, will show ACLs: 

S is *Ie sontefilen txt 

-rw-r-r- + 1 marczak marczak 6236 Hay 10 22^52 somefile. txt 
0; user;marczak allow read 

Pretty straight forw^ard. The “-a" switch will remove a 
pennissionr 

S chmod ~a “marczak allow read*' aomefile. txt 
$ la ‘le somefile.txt 

rw r-r- + 1 marczak marczak 6236 May 10 22:52 somefile*txt 

When assigned via choiod, die language you use to 
specify the pennission is a littie different than die 
phrasing used in WGM* Here's a list, riglit from the 
chmod man page: 

The following permissions are appHcable to all 
filesystem objects: 

delete tX^lete the item. Deletion may be granted by either this 
permission on an object or the delelc^child right on the 
containing directory* 

readaltr Read an objeas basic attributes* Tfiis is implicitly 
granted if the object can be looked up and not explicitly 
denied. 

wriieattr Write an object's basic attributes, 
readextattr Read extended attributes, 
writeextaftr Write extended aiirihuies. 

readsecurit) Reiid an ohjeefs extended security intbmiiition (ACL), 
writesccurity Write an object s security information (ownerslup, 
inode, ACL), 

cliown Change an ofiject's ownership. 

The following permissions are applicable to 
directories: 

list List entries. 

search Look up files by name. 
add,aie Add a fde. 
add^siibdirector)' Add a subdirectory* 

delete_child Delete a cxiniaincd object. See the file delete 
permission alxjjve* 

'rhe following |>ermi.ssic>ns are applicable to non- 
directory filesystem t)bjects: 

read Open for reading* 
write Open for writing* 

append Open for writing, but in a fashion that only allows 
writes into areas of the file not previously written* 
execute Execute the file as a scrii>l or program. 
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ACL inheritance is controlled with the following 
pennissioas words, wfiicli may only be applied to directories: 

filejnherit Inherit to files, 
director) Jnherit Inherit to liirectories. 

limit inherit This Hag is only relevant tt) entries inherited hy 
subdirectories; it cause^s the diFectoryJnherit Hag lu Ik.‘ 
cleared in the entry that is inherited^ preventing further 
nested sulxlirectories from also inheriting the entry. 
only_inherit 'llie entry is inherited by created items Inn not 
considered when prex'essing the ACL. 

Let's kK>k at all this a little more closely. Now, even if you 
do not use the '‘-e’* switch, you should notice something 
about “Is": 

$ ifi -1 
total 1529032 

drvxr jcr « 3 marezak raarezak 102 Apr 29 15:58 Appa 

drwxtvKriDt + 19 maresak oaresak 646 May 5 23:43 B&aidflf: 

Rven just using the *“-1" switch will alert you if tlierc Ls an 
ACL asstx-iated wiih a .something in the list - notice the 
“3^” immediately following the POSIX permission list. To 
see the entries themselves, use the “-e” switch: 

$ Is -le 
total 3529032 

drwxr‘xr-x 3 marezak mareizak 102 Apr 29 15:58 Appa 

drvxrvxrvfx t 19 (narezak niarczak 6A6 Hay 5 23:43 &esides 

0: uaec:supervlaor deny list, delete 
t: grottp:stafr fillow ll«i 
2: user :tnarczak allow list 

There Lk f)ne other way to see the ACL. In the Finder. 
Ap[ile lias Lipdated the Get Info btix. If a file or directory 
has an ACL, youll get ACL info in the 'Ownership ik 
Permissions" section (Figure 4): 


This is nice, but somewhat useless. I'll explain why in 
a moment. 

Here are some critied things to note: a) if an ACL is 
present, it J.s consulted first! If someone is trying to access 
a file, and an ACE matches, the “can I or can't !" search 
stops, and the POSIX pennissions don't even come into 
play. If there is no matching ACL, you ‘fall through' to 
tlie POSTX permissions, h) in the previoiLs command line 
listing, notice that each ACE is jireceded liy a nimiber - 
this is the most itnptinant thing to (>ick up on. ACLs are 
like firewall rules. They are read m order, and the first 
match determines the permissions. IhLs ts why the 
Finder view is useless. Compare tiie command line listing 
to the Finder listing. Not the same order, are tliey? 
(Would that have lx:en so difficult.^) 

In our example above, even if 'supervisor' is a 
member of the “stafr group, they are denied the list' 
ability for dial folder (though, yt)u'd never know it from 
the Finder). Like firewall rules, this lets us set up some 
t:omplex niles gewerning precisely which users have 
access to wliat. In a large system, this will need to be 
planned out, as it could become messy railicr c|uickiy. 

Of course, the updated chmod command includes 
ways for us to keep the c;)rder of list entries correct. Use 
the new switch to insert an ACE in a specific 

location. Given the former list of entries, we can deny a 
user wIkj may be a part of the staff group by inserting the 
aile ahead of entry' 1: 

# chmod +a# 1 **eraily deny refld“ Beflideir 

# Is 'Ide Besides 

drwxrwxrwx + 19 martzak oidrcznk 646 May 5 23:43 Besides 
0: user:supervisor deny list,delete 
1: user:erally deny list 
2: group:staff allow list 
3: user:marczak allow Hat 


Y Ownership & Permissions: 

You can read and write 

T Details: 


Name 

Privilege 

^ marezak 

List entries 

li staff 

List entries 

^ supervisor 

Deny D...t entries 

r 


Apply to enclosed items... . 

--- ^2, 


Figure 4: The Finder now groks ACLs too. 


Similaily, you can remove siiecific entries using the 
a#" switch: 

# chmud -a§ 1 Besides 

will remove the entry for “emily deny list". You can also 
rew'riie entries in place with “=a#": 

# cbmod =tiiE I “staff deny list" 

will change our staff allow' entry to a staff deny entry. 
Lastly, know' tliai entry adding is t'Uinulative if entries 
match. So, this: 

ff chmod “mikeb allow read“ file.Txr. 
ff chmod ^mikeb allow write" flle.txt 
j chmod ■'ftikeb allow del ere” flle.tKt 

is equivalent to: 

# chmod "'mikeb allow read .write.delete* file.txt 

Kememter the order! If, in your testing, your ACl. is not 
working the way you expea, urn an “Is -le" on the file 
or directory and check the order of the entries. 
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Another reason you should plan/rejoice: Now, 
groups can be niemters of other groups. Fantastic! This 
is obviously a huge lxx>o to anyone serving inultiple 
groups. It’s Mimcthing you simply couldn’t do with the 
basic Unix groups and FOSIX pennissions. Now the 
(small) downside; tliis ability is Server-only. Of course* 
you re^illy only need this al>ility if you're managing gobs 
of users and groups - and if you are really managing that 
many users and groups, you should be using OS X Server. 

Cool Stuff 

The great thing about all of this rncLadata - the purely 
arbitrary, and the ACLs - is tliai tliey transition nicely into 
cnvironinenls that don't support them. Let’s say you have 
a Firewire drive, enable ACl^s, and also assign some 
arbitrary metadata to some files on it. You can then take 
that drive and use it on a Panther machine with no harm. 
If [x^nnissions aren’t ignored, the POSTX permissions take 
over. Bring it back to Tiger, and everylliing is where you 
left it* Of course, changes and additions to data won’t be 
in Spotlight, and will need to be manually impeded. 

So then, how does the OS do it? Where are these 
permissions that can gcj froni system to system witliout 
getting crushed, and then back to Tlie original unharmed? 
This goes back to the beginning of the anicle. IVs the 
whole reason 1 discussed metadata at alL ACLs are just 
another form of mctadaia* TliLs particular metadata gets 
.stored in llie extended attributes of 1IFS+* OS X dot;s treat 
the ACL metadata a little differently, of course. It’s 
protected from you altering it outside of tlie 'proper' 
methods (chmod, the Server GUI, or one day, when we 
have APIs higher up the chain***)* Namrally, if the POSIX 
permissions allow you, and you bring the file to a system 
that doesn’t understand ACLs, you’ll be able to alter the file. 

La.stly, ACLs are respected through a cxmneciion tti 
the server. So, if you’re running Tiger server, but your 
clients are not up to that yet, feel free to start applying 
ACLs on the server. Because the .server is re.sponsilile for 
the presentation and access to the files in this case, the 
ACL permissions siill come into play* 

Caveats 

There are a few things to be aware of with ACI.S. 
Unlike other metadata, cp and rsync won’t copy ACLs. 
mv works on the .same partition sim[>iy l>ecause you're 
n<5i really changing die inode* 

Again, in a large system, this will take some planning 
“ including making sure that if there's no ACL match, the 
POSrx permis^sions protect you* Tliat, and other file 
mcLadata can still be set programmatically with 
setattrlistO, chmod, chown and utimes, by the way. 


ShutDwnPower 

'Ihis was a good amouni to cover diis mondi, but 
wow, it feels gicat lo lx: Uilking about the teclinologies in 
Tiger! For everyone wiio has had to do the POSIX dance 
to allow various groups to access a common data store 
securely, here are iK'tter tools. For everyone that can 
imagine all of the way to put metadata to use, more pciwer 
to you! I can’t wait to see the things that will come of it. 

If you’re interested in exploiting this power, Apple 
has done a good job with the respective man pages, and 
that’s where you shoultl start. From a .system manager’s 
perspective, the man page for chrmx) is an excellent 
Introduciion and reference document. Check it out* 

Next month. I'll talk a little more about Service ACLs, 
metadata and Spotlight, and touch on WWDC 2005. 
Meanwhile, I'll lx: upgrading Servers to I'iger and 
planning tlieir ACL layout.. .naturally! 

Wtl 
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The Saga Continues... 

// is another peaceful day in the Fuml of Smiles. The twather 
is beautiful the people are bal^jiy mui tlala is fiowing smoothly 
It is one of those days UmU seem just tm g(M>d to i>e truiK 

But as uith many ounmnlly pleasant things, there van he 
trofthle lurking Just beneath the calm surface. Emry day has Its 
pmhlenjs and challenges in spite of the beauty and apparent 
harmony we see annmd tts. Bat that is life - and we mtly tmly 
gn}w by facing new challenges, demloping netv skills and 
solving new problems. ExhiUmtlion is the state we achieve fiir 
each such i^fcle we complete. Prom that peak of personal 
triumph u^e can see netv possihilities spread out before us - 
until we are forced to focus again on the next struggle... 

In our ksi cpiscxlc, we saw how easily table staicmres anti 
aSvStxnated data oin fx* converted from one SQL tlatal>ii.se plaifonn 
to ;inod)er using some of the [lowerfiil feaiurCsS of tlie Omnis Smdto 
SQL Browser utility. All went smtxjLlily and without incident when 
the database tallies used simple and nonxxmtroversial data types 
and otlxwise followed all the rules. In faa^ mcssi of ilie dialog 
windows that appeared to ns during llie prfxess may have seemed 
superfluous and felt like impediments to our piogreas. But there 
can just as easily lx cases wheie these dialogs prove very lielptuL.. 


3y Dt!nvid SivisniH 


The series of dialogs mentioned above opens for each table 
in .succession when we attempt Uj transkiie multiple tables m a 
single operation, if there are no problems [presented and the 
default Ixhavior is whai we want, we just accept each one with 
a simfdc Return keystroke or mouse dick. There were no 
pRihlems with any of the tables we chose to translate last time 
because the data and siruclures from one databa.se were 
compatible with the other. We were lucky-this will not always 
tx the case! But l^efore we continue, a little housekeeping... 

If you are just joining us. this project Is a continuation from 
the one w^e began in the last issue. In fact, we also covered 
some important background infonnation on the availability of 
enterprise-level databases and application development tools For 
Mac OS X — including iiow to download, install and license the 
ones used in these exercises for free! CX) w'haiever you can to 
obtain the March 2005 issue of MacTec h and work through the 
example exercise found in the previous article. You 11 be happy 
you did! 

And if you u*ere with us last time, we apologise for a slight 
oversight. There was to have been a sidebar or preamble 
accompanying the anicle explaining that one of the application 
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vendors had made available a special demon.stration version of 
their to|>of-the-linc prtxluct (and a significatit discount on the 
f)urchase of a ftjll copy as well!) exclusively for MacTecIt 
readers. In ortler to take advantage of this offer ( which Itas l>eeii 
extended tliitjugh July 2()05), an applicant nc'eds to supply a 
special cock that was to be included in that sidebar 

That axle is MT002 h To learn more alxHU that offer, go to tlie 
MacTech Readers page of the Otnnis web site at 
http://www.amnis.net/mactech/. You will also encounter this cixle 
anti a link to the associated URL by accc.ssing the insrajaions for 
dow'nloading, licensing and installing ProntBase, OptmBase and 
Omnis Studk) demo versions for the previott.s article in this series 
found at http://www.davidswain.com/mactech030Sswinstall.html . 

Dealing With Conversion Problems 

In llie liLsl article in this series, we made gre'at progress in 
translating a database named CJompany from OpenBa.st* to 
Front Base by a simple drag-and-tlrop process using the SQL 
Browser facility of OninLs Studio. We traaslated ftr.si a single table 
and then a group of tafiles and the pixxess was completed without 
a hitch, ‘Ihat was tw easy! But we left two tables for anotlier time 
lx:amse they might have some problems. The rest of this article 
assumes you Itave read through (or, l>etter, woikccJ through) the 
exercise in the previous article in MaeTech, March 2005. 

So let’s tackle a table witli a conversion problem! Try 
dragging the transactions table from OBCompany it) FBCompany. 
It all begins pleasanliy enough, just like the others did. The table 
structure looks fine and the data Ijegins to transfer and then 
Bang! An error messjige appears! 


Kxperience tells us that FrontBase is a hit fussy about 
certain things, adhering closely to standards as it does. One of 
those things we remcnilx-T is that it does not like to arceive 
empty values in Date cokimns. Standard SQL does not 
recognize an "empty" date value, but exfx:t:ts to see a NULL 
value if no date value is given. Becaii.se it strictly adheres to SQL 
standards, FrontBase prefers either a valid date value or a NULL 
value. 0(X!nBase isn't so fussy, so [XThaps an empty' value or 
nx'o sneaiked into this record. One way to find out is to set the 
values of these two columns in this record to NULL and sec 
whctlicT that fixes the transfer problein. 

We need to do this with a specific SQL statement, This 
statement not only needs i[) set the value of these two columns 
to NULL, hut it needs to do so for only tit is one reajfd. If we 
don't qualify thi.s, the two columns will l)c set to NULL lor a// 
records in the table, wiping out valid values in other records in 
the .source data. So we need to find a way to distinguish this 
record. Mt).st prognimmers would put a unic]ue id column of 
some son into a ml)le, but there doesn’t appear to Ije one here. 
(OpenBase maintains an imcrnitl column named _rowid, but 
this is genereated by the system and is pan of the data per 
se - so it is not available for export.) Most of the column.s in this 
record are, in fact, eiTipty so there aren't loo many choices for 
selection criteria. Kortimafely, the value of 572 in the Credit 
column ap|>ears to lx: unique within our 29 rows. While we can 
safely a.ss.ane that this column was not intended as a key 
column, we formulate an SQL statement in iliLs .specific case to 
perfonn our correction as follows: 

update transactions set card_axpiration ^ HULL, 
rrauBactionnaio = NULL where credit “ 577. 



error #1 Transferring Data Into 
transactions: 3S - Syntax error 035. 

Improper DATE literal* 



r-oK3^U-. 
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Figure V. Improper Date Value in Record 4 


We can't move these dialogs, hut if we look in the shadow 
of the Error dialog, we see that the error ocTurred when 
prtK'e.ssing record numf)er 4 out of the 29 records in this table. 
This table isn’t very large, so we ean use the Interactive SQL 
window' Lo lcx)k at record numlwr 4. To do this, we dismiss the 
error dialog and then u.se the Show Data..* context menu item on 
the transactions cable by control-clicking (or right-clicking using 
a muiii-biitTf>n mouse) on the ici>n far that table in the 
OBCOMPANY_Tables window. 

We first notice tliat there are two Date columns named 
card^expiration and transactionDate. Both of these apixfar to 
he empty in record number 4 (as does most of the rest of the 
record), so we must think back alx>ut what we know regarding 
our three products. 


'I'he Interactive SQL window we used to view the data in 
this talkie also allows us to make such a correction. We simply 
type in the SQL statement we want to use and then execute it 
by clicking on the Run button (the one with the ainning person 
icon) in the toolbar of the window: 



Figure 2. Statement to Replace Empty Date Values in 
Record 4 With NULLs 

We won't notice any cliange in the acord image het'ause 
lx)tli empty and NULL values are represented tlie same way in 
this window {which has changed in more rec'ent versitjns of 
Omnis Studit>), but no error message was triggered by the 
execution of this c<xie, so we can assume dial ilie value 
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assignments were successful After we have made this ct^rrcctioa, 
we can then close tJiis window and reiiim to the Tables view 
windows to see wliether our transfer can now i>e accomplished. 
But when the SQL Transfer dialog appears this rime, wc want to 
c/e-select copying the structure because that happened 
succe,ssfully the first time. If we leave lliat checked, a dialog will 
ap|x?ar telling us that a lablc named transactions alrejidy exists in 
the taiget database and |>roinpting us for a new table name. 
Since we do want to use tlie existing tmnsiictions table in 
FBCompany, w-e uncheck Structure in the dialog l^efore accepting. 



Figure 3. Data Only Transfer 

Once this is done, llie data transfer runs with n(> pn>bleim, 
so our giies,s tliat empty Date values were the cause of the 
problem was correct. Now let's try ihe last table. 

Drag the contacts table from OBCompany to FBCompany. 
Omnts !Studio asks us to verify the column structure of the table 
as alw^iiys, but after we accefit this, ii ctmies back with an error: 


OOn 


SQL Transfer Retry SQL Script 


An Error occurred cxcctitlng SQL during tlie SQL Tran if tr. You nuy moddy 
dw icrfpt and retry. 


! Q; No error 


i VARCHAR{Z5ej.lastname VARCHAR(2561.mldlriif VARCHARl^S6J,phonel 
VARCHAR(2S6).phDne2 VARCHAR(2Sehp^ure BLOB.tiineUpdated 
UME.group VARCHAR<2SiLcystomHeld7 VARCHAR|2S6^cuftoniftetdS 
VARCHAR(2S6)xuttoni1ield9 VARCHARllSeKcustomffeld IQ 
VARCMAR(2S6J.cuUomfieldi 1 VARCHAR<256Lcw$tOinfterdl2 

1 tjk j, 1 r«, ar-un Af 1 r £ I n ....ii* 


^ Retry f ( Cancel } 


Figure 4. Error When Trying to Create contacts Table in 
FBCompany 

Something is wrong with the data stniaure we want to 
impose on our FrontBase databa.se. No oilier infomiation is 
given, tlKJUgh, so we have to work this out ourselves, ('llte error 
dialog, which comes from ihe Frt:>ntBase DAM, reports ‘'no 
exTor" - St) weVe on our own!) iTiere are 90 columns in this 
fable, so let's ho|>e it’s something simple! 

Rather than waste your time trying to find a realiy obscure 
problem, here Ls die answer: Tlie person w'ho set up the table 
in OpenBa.se used a FrontBase reserved word (actually, an SQl. 


reserved word) for the name of a column. Tlie name of thi.s 
column is group. Again we have a difference in cultures. 
FmntBase is wilhin tLs righls to impose the restriction that 
reserved wt>rds sliould not lie used for other purposes. Ihe SQl, 
standard clearly lists GROUP as a reserved key word. On the 
other hand, OpenBa.se is within its rights to ignore this 
restriction tn ihal standard as long as doing m does not lead to 
problems within tlie rest of its operations, Tliere is a segment t>f 
the enterprise datalrase market to which each approacli will 
appeal. Our job itere is simply to find a solution to the problem 
of translating from one system to the other. 

The simplest thing to do is to change the name group to 
something that FrontBase will accept, but which is still 
descriptive of the fLmetion of the column. UK>king at the data we 
see iluit die column cont:uns a (lair of numbers each enclosed in 
square brackets, as if there might be two group identifiers or a 
group and sul>grouj> identifier in each row. Witliout further 
analysis, w^e might decide to use llie name groupfds (which is 
nor reserved) for this column in the target database. 

So liow do we handle tiie problem? We can either locate the 
column de-scription in the SQL Transfer Retry SQL Senpt windtiw 
sliown alx)ve and change the column name there (if iliat window 
is even still open) or we can change it in the Destination Table 
Structure Verification dialog we see when we first l>egin the tnmsfor 
prcK:css if we choase to start the pnxress over Either way, we will 
see that the stniclure transfer process now goes smcxjthly. 


Error #1 Transferring Data into contacts: 
15 - Syntax error OIS. Improper DATE 
literal. 



Figure S. Improper Date Value Error for contacts Table 

But wait! *11iere is still an error in transferring tlie data. It 
doe.sn’r happen Lintil record numlier 397 of the 512 records we 
must convert, but it still causes die entire' lot to be rolled Ixick. 
Ids another Date error, 

A brief Icxik at the structure of this table reveals tiiar we 
have three Date columns thi.s time, but an equally brief kxik at 
the data shows that two of these columns are completely filled 
with valid date value,s. So the problem must lie within the 
callBackDate column, which has many empiy-kx>king cells. 

WIiLle diis error didn't (xrcur until we were almost through, 
we don't know whethiT this is the only one. (Of course, we could 
always perform a SELECT on this criteria, but.,.) Rather tfutn take 
chances on fixing this for one ret'ord wlien more may have the 
jm>biem, we ntn formulate an SQL statement that fixes the all: 

update contacts set callBackDate ■ NULL 
where callBackDate = '' 


6b May • 2005 


WWW.MACTICH.COM 



















































eoe 


Interactive SQL 


OBCflMPAWy_ I ExtmpHf 0| y fBJ \ $J 


u0ditt CQtiiici^ ■ NULL wh^re C4il&ickpatt > 


n 



aUfackIfImt 


r - ■ 






15 MAY 19»a 

lOrM 

\ 

u 

_ 





OIL SU Hews Query tKtcution tJme Hcofwiv 


Figure 6. Statement to Replace Empty Date Values in 
callBackDate With NULLs 


Once we execute this, we can try our transfer once more. 
Again we only need to transfer the data, not ilic .structure, since 
the stRiclure transfer has already been accomplished* Omnis 
Studio ]:)erforins tliis transfer on a column-hy-colinnn liasis, so it 
does nos niarter that the group column lias a different name in 
the target Uihle. 

We have now perlbnned a suc:ces.sfLil conversion of both 
table siructiires and data from one datal)ase to ti not her* We did 
not I lave to export the data from each table into a lab- 
delimited file, massage that data in spreadsheets to put it into 
I lie proper format for import or manually import it into the 
target dalabase. We just dragged table images from one 
window to another. If there was a prolilem, the utility told us 
af“K)ut the problem and then rolled hack the transaction 
(structure and tbita transfers were separate iransactions) so 
that we wouldn't have to deal with the additional headache of 
partial transfers. The utility also provkled r(x>ls that allowed us 
to s<ilve what problems did arise* 

But tliis drag-and-drop tiatabase conversion is only a parlor 
trick compared to tlie features of Omnis Studio that help us to 
build front end applications for SQL databases! The DAM 
technology [)e‘hind this utility feature offers us many more 
advantages for tmly rapid application development! 


The Man Behind The Curtain 

Let me feU }f(m a secrei - thtnv realfy is no ma^ic. Theiv is 
only technology of which the casnal observer either is not 
mmre or chooses io remain ignorant. It is this option for 
ignorance that most often keeps the samj practitioner in a 
iHisiUon of /jowei: but sometimes techmMtrtists detiheratefy 
keep their technologies secret atui shroud them in mystical 
UKtrds and incantations. They do not readily disclose those 
mysteries to just anyone - and sometimes they only confide in 
a small group of loyal apprentices tvbo can carr}' on and 
expand upon the original work. 

When Omnis Jirsl decided lhal she wanted to be able to 
create data (fhjects that could address the master databases, she 
had an idea for a tecbnology that could be ttsed unitersally 
with any of them. This was not her ftrsi innomlioth but it has 
become known as one of her most poimrfut... 


Omnis Studio can only translate column definitions and 
data from one database platform to another by temixmirily 
assimilating that data itself. No translator can interpret 
effectively without listening to and iindcrsiitncHng the woixls of 
tile firsi sfx:aker Ix^cause that understanding is the only way the 
full and proper meaning <if the originiil utterance can lx: 
C'onveyeti to the rec'eiver. Omnis Studio performs a similar 
service, as we have already seen, so it must set up a teniporar)^ 
table structure with appropriate data types for all columas so it 
can handle the translation on its own terms* 

Tliai i.K one purpose c^f the Omnis DAM leclinology. h maps 
column definitions between Omnis Studio variable data types 
and corresjxjnciing data types on the target SQL back end. This, 
in turn, gives us a basis for building applications for existing or 
new SQL databases because we can directly create Omnis 
Studio Schema Classes from database tables (or the other way 
around) by the same easy clrag-andxJrop technique* 

A Schema Class is the direct analogue to an SQL database 
table definition, but it is a coast iikt contained within an Omnis 
Studio library'. It includes in its contents the name of the 
daialiast: table for wdiich it serves as a reflection so that variables 
derived from it within an application can lx: automatically 
Ixxind to apprD[)riaie columns within that table of the database. 
Let's create one and see what we gel. 

Adding Schema Classes Tb A New LiLxaiy 
T!ie first thing wc mu.sl do is create a new library file to hold 
tht^ elements of our application. If the Lifirary' Browser window 
(named Libraries in its title bar) is not open in our copy of OmnLs 
Studio, we can most easily ac:c:css it by pressing the Command-2 
key combination. It is also available ilirt>Ligh the View menu as 
well as liirough an ia>ri on tlie application toolbar that kxiks like 
a compass and lias a uxiltip that says Browser. The window will 
be. empty, L^ut if we click the New Library burton (the stack of 
books on that window^s ttxilbar) or select Ubrary>New..* from 
the window's menu Irar, a lihniry icon will apjxar as show-n in 
Figure 7* llie name of thi.s library defaulLs to New Library, but we 
can change it to read whatever we want. If we want to .share this 
file w'itli our Windows asing friends, it Ls couiteous [Practice lo 
append a .lbs extension to the name. This extension will not 
appear in the Libraries window, but it wall appe^ar in the Finder* 



Figure 7. New Library in Library Browser 
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To view ihe contents of our new library file, we r^n simply 
ckjutjle-elick its icon in tJie Libraries window. This oj^ns the 
Class Browser window for that liijmry, which displays the name 
of the library in its title l)ar In Figure 8 we see that a new iibraiy' 
contains only one class named Startiip_Task by delaull. No time 
la explain that one now, ihongli. We are alxrut to add some 
Schema Clas.se,s to keep ii company, 



Figure 8. Class Browser Displaying Default Class for a 
New Library 


Hopefnlly we all siiil liave the FBCOMPANY_Tables window 
open. If not, quickly open the FBCOMPANY session and drill 
down to the Tables view. Click on this window to make it 
topmost and then prexs the Command-A key combination. 'I'his 
will select all ihe laljles in our Company database^ on FroniB;i,se. 
Now^ just dnig them over to the New Library Class Browser 
window and drop them there. There .should I>e no data type 
issues for any column in any of these tables, since they were 
created l^y dragging tables from the OptmHuse version of tliis 
database in the first place. The resuli is a set of Schema Classes 
in our application lil>rary that properly maps to the column 
definitions of each table in the database, as shown in Figure 9* 



Figure 9. Dragging Tables to Create Schema Classes 

Just to check and see that all went well, we can double-click 
on a Schema Class to view lire details of the ajlumn definitions 
it contains. We can do the same for a Table in the SQL Browser 
Table View window. ITie data types we see there are tliose for 
the datalxtse platform, while the data ty|x:s in the Schema Class 


are those for Omnis Studio. The mapping of data types is built 
into the DAM for the SQL database we chtx)se to access. 
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Figure 10. Schema Class and Database Table Details 


If we had instead developed an at)j)!icatioii finjt and then 
wanted to use FrontBase as our database, we would have 
already built our Schema Classes by hand. In that case, we touki 
rcvci'se the process we followed above and dragged the Schema 
Classes to the Tables view of our database. Tables would have 
l>een c reated in the database as a result. In fact, we uiiglit liave 
build an application tor OpenBasc and then decided to use it 
with FrontBase (ot deploy it for another customer who uses a 
different SQL database). If we had not done any programming 
that requires [iroprietary feamres of ihe original database 
jiroduct, the application should work as well with one back end 
as another. Of course, it's never quite that .simple, but you’d l>e 
amazed at how easy it is even when differencies are involved. 

What Next? 

N(jw that we have cloned the table structure from an SQL 
database into our appliotion library, we can l>egin the proces-s 
of building a simple Gilt application for the database, Bui that 
is a subject for another time. 

In the next ankle, we will examine liow Omnis Studio uses 
special thita typt^s called Use and row vniiihics to map the 
eokimns of an entire Schema Class onto an ejisy-UHiianipulate 
inulii-valued unit whose columns are auiomaiically lx>und to the 
columns of the corrc'sponding database table. We will also see 
liow we can bring other features of the DAM ttxlinology alive by 
crciiiing Object Instances and Tat>ie Instances that inherit their 
abilities from DAMs. If yriu have done SQL [>r{jgramming in other 
application dcveloj>nicrU .software, prepare to be imprc'ssedl 

'i'll I 
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'PLESCRIPT ESSENTIALS • by Benjamin S. Waldie 


What’s New With 
AppleScript In Tiger 


While iTiany of tlie new features in 
Tiger are geared toward the user level, there 
is also pknXy lhar is new under ihe hcx)d for 
devel<)|x.‘rs. Ft>r ApplcScripters, Tiger hrings 
with it a number of bug fixes and new 
features with the latest release of 
AppleScTipi, vei^iion 1.10. In this nuinih’s 
article, we will walk through a number of 
the.se changes and enliancements. 

AppleScript Bug Fixes 

Like most openiUng system updates, 
Tiger offers AppleScript developers a 
number of bug fixes. Let’s touch briefly on 
a few of these, and then we will move on 
to the exciiing stuff, the new AppleScript- 
related features in the OS. In addition to a 
number of others, the following bug fixes 
have l^een introduced in Tiger: 

• Memory leaks in both A]ipieScripl itself, 

as well as in the .Standard Additions 
scTipting addition have been fixed 

• AppleScript has licen updated to allow 

for compiling laiger scripts, as well as 
generating larger static lists. 

• In Mac OS X 10.3, retj-ieving the POSIX 

]>atli of a string that is already in the 
POSLX file format would produce the 
incorrect result. ThLs ha.s now been 
fixed, for example: 

tinder Mac OS X 103*Pinthen 

POSIX path of 

’7 Users/bwfeildiig/Desktop/” 

—> ”/:Users:bwaldie:Desktop:” 

Under Mac OS X 10.4,Tigcr: 

POSIX path of 

"/Users/bwaidle/Desktop/” 

—> ‘7Users/bwaldie/Desktop/" 


A .slew of other Inig fixes have also l?een introduced with 
Tiger, For a comprehensive lisi of hug fixes, view ihc 
AppleScript Rdettse Ncncs, availai:)le in the Apple Developer 
Connection Uhniry^, Also, if you encounter a bug with 
AppleScript, or any other Apple technology for that mailer, \ye 
sure to submit it via the hug reporter website at 
http://bugreporl.dpplexom. You will need to have at least an online 
ADC membership to log into thi.s website. 

New AppleScript Features 

While bug fixes are exciting in their own special way, 
ihc real fun comes with all of the new AppleScript features 
and additions in Tiger. Throughout the remainder of this 
month's aiticle, we will discuss a handful of these new 
features, lei's siari with Script Hdilor. 

Script Editor Enhancements 

Willi the release of Mac OS X 10.3, Apple inirtKluced a new 
and improved Scrifjl Editor, version 2.0, a long awaited and 
much needed upgrade from its predecessor. With 'I'iger, Apple 
continues to expand ihe functionality in Script Editor with the 
release of version 2.i. 

In the latest version of .Script Editor, you will find an enliiinced 
version of the S<Tipt A.ssLstani, which helps to auto complete your 
t:ode as you type. Enabling tills fc-atuie in Scrijit Editor's preferences 
now^ no longer requites tliat you re-kiunch Script Editor to begin 
u.sing the feature. In addition, the latest nentistion of iJti.s feature is 
now able to amo-c:ompleie varial)les and liandler names. 

J inyAwescHateHazidlerl. .. 

|B myAwesomeBandler 
iB inyAwesontcaandlerl 


I inyAwe8omaHandIcur2 


; .. .1 

Figure T. Handler Call Auto-Completion Using the 
Script Assistant 
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ately, there has been a lot of buzz about Tiger, the latest version of 
Mac OS X. This new operating system version is full of new 
h features and other goodies. With new applications and utilities like 


Dashboard, Spotlight, and Automator, Tiger is breathing still more new life 
into the steadily maturing Mac OS X. 


You iTuiy recall tliat Mac OS X 103 Inlroduccd tlic ability to 
save AppIeSt'ripl ftles in buntlle fonnal. By saving a script as a 
bundle, ret|uirecl resources c:t>uld embedded directly into the 
script's bundle via the Finder, eltniinating ilie need lor llic ,script 
to kx'ate and acceas external requimd coiiijx)nents. Script liditor 
11 takes scTi[)l bundles a step fiirlher, by allowing you to actually 
edit the contents of a bundle fioiii directly witfiin Scri[>t Editor, 
When editing a script that has l>een saved as a bundle, click 
the Bundle ComeniH butnm in the script window's toolbar. The 
contents of the l.’Jundle will Ise disj>layed in a drawer attached to 
the window. New components can be added to tlie script l>undle 
by simply dragging and dropping them directly into the bundle 
coments drawer Bundle comptments may also lx* deleted, 
renamed, opened, and duplicated from wiUun die drawer. 


CD 


Bundle Contents 




Contents 


applet Jens 
;S description.rtfd 
► P Scripts 


Figure 2. Bundle Contents Drawer 

Possibly the most exciting and visible feature of the latcsi 
version of Script Rditor is a new AppleScript dictionaiy bmwser 
layout. Tills new layout tJlTers a completely redesigned way to 
navigate AppleScript dictionaries. 


M/cmm 



Figure 3. New Script Editor Dictionary Browser 

Viewing an AppleScript dictionary in this new' 
browser display may seem a little confusing at first glance. 
However, you will quickly find that the new' foniiat is 
atiually {[uite easy to use, and contain.s a numlx^r of 
Ixrnefits over previous dictionary browsers. Before long, 
you will wonder liow you ever worked wjihoLit it. 

At the top of the dicrionaiy browser, you will find a 
Uxilbar, complete with navigation buttons and a search field 
for performing quick terminology seiirches. If desired, the 
t(x)lbar may lx* custom configured, or hidden entuely. 

With adjustable navigation panes, fhe dkTionary 
browser window itself may lx; configured for navigation 
using columns, or in the familiar list view format of 
previou.s script editors. By r:ollapsing and expanding the 
panes of the browser you can design the layout u> a kK>k 
and feel tliat is coniforTable for you. Once you have 
finished customizing the layout of the dictionary browser 
to your liking, select 5ave as !X*fliuk from the Wndow 
menu, and all fuiure dictionafy browsers will a|xn using 
your custom configuration. 
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While navigating a dictionary in column view, tiie dictionary's 
icnninology will lx* displayed in suites by default. Selecting a suite 
will display a list of comni;inds and classes within that suite. 
Optionally, you may chtxxse to view a dictionary by its class 
containment tjr inheriLance, allowing you to gam an understanding 
of die class hierarchy witliin the dictiomiry. tliis can be dtme by 
clicking the desired view button in the icx)lkir 



Figure 4. Viewing a Dictionary by Containment 


As you explore llie new dictionary browser, you will notice tliai 
each lenn in the navigation panes is preceded by a cx>lc>r-cxKled, 
blxled \am. icons indicate the type of icmi For example: 

• An orange square containing the letter S indicates a suite 

• A blue circle containing the letter C indicates a ctjmmand 

• A purple s<|uarc containing the letter C indicates a cla^ss 

• A pur()le sc^uare containing the letter F indiaites a property 

• An oninge square containing the letter H indicates an cflemeni 

Anoilicr very exciting feature of Script Editor's new 
dictionary browser is that liy|xrlinks now provitle cjuic'k and 
easy one-click navigation Ixtween related terms. For example, 
ytni can select a class in a dictionary, and click on one of its 
elements to go direclly to that element. 

In Tiger, developers can now even chcxise to enhance their 
product’s AppleScript diciionaries l>y including comprehensive 
HTML-l>ased dtxumentation, which can even include example 
scripts and URL's, all c<>niained and viewable witliin llie 
dictionary itselR Hojxfully, developers will be quick to adopt 
this new functionality. One application that is already taking 


advantage of tliis new capability i,s ITeFab Softw'are's U1 Actions. 
The Applefk'dpL dictionary for die latest release of UI Actions 
includes exteasive documentation, along with sample code to 
gel scripters up and running in no time. 



Figure 5. PreFab UE Actions Dictionary with HTML 
Documentation 

PreFaI> UI Actions provides ApplekTipr tievciopers with a 
way to universally attach sc'ripLs to almtisi any application. 
IJ1 Actions can Ix configured to trigger scripts when users 
click buttons in an applic^ation's interface, .select menu 
items, open a wintknv, and much more. Find out more 
about Prefab LIT Actions, or download a 30-day trial 
version at http:/Aiww.pfefab.com/ijiaaions/. 


AppleScript Utility 

Outside of Sttipt Editor, Tiger iiim includes a numlxT of otlicr 
new AppleScripL-relatecI featurc^s. One such feature Ls a new^ 
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AppleScript Utility iippliaitkin, wliich provicles a centrist tcxiition 
for pertomiing a numlxT t>f systcin-wide AppleScript-related ta.slcs, 
such as changing your default script editor, enal>ling GUI f>cTi[Hing 
or die Stript Menu, or working with Holder Actions. Iliis utility can 
lie found in the A/>/j//£iit/r>n.v > AppItScript folder. 


that the display dialog command has lacked is the ability 
to hide text entered by the user.,, until now. Tiger features an 
updater! display dialog command, wtiich now includes a 
hidden answer panimeier, allowing text enteieci by the user 
to be displayed as liullcis. For example: 


0 Q O _ AppleScript Utility _ 

Default Script Effltor: ' 7 Script Editor (2. 1 ) 1'-$^ 

GUI Scripting: □ Enable GUI Scripting 

Enabling cut Scripting will alto enable acc«& 
for astis^tive devfcei. See Universal Acceis 
preferences for more ir^rormatiDir. 

( Uftiver^l Access.,. ) 
folder Actions: ( Set Up Actions- ) 

0 Show Script Menu in menu bar 
5f Show UbraiY scripts 

Show application scripts at: O top 

©bottom 


Figure 6. AppleScript Utility Application 

New Standard Addition Commands 

Tiger also brings with il some new and enhanced 
AppleSfTipt leniiinology. Some of thus new temijiiology can be 
found in ihc Standird Additions scripting addition. 

In the User /fifenfci/on suite of the Standard Additions 
scTipting addition, a command for displaying a new type of 
interface dialog has l>een added. A new display alert 
command will allow a system alert message to be displayed to 
the usen 'Ibis command has a numlKT of ttmfigunible 
parameters, including ilie text to Ixf displayed, the level of Llie 
alert, and the names of the buttons. The follow^ing is an 
example of code that will display a Irasic alen dialog: 

display alert "An error has occurred.’' message "Document 
could not be found-" as warning 



The display dialog command in the Standard 
Additions scripting addition h;us always been a popular w^ay of 
displaying a Ixisic message, or re<|uesiing text input from the 
user during the execution of a script, without the need to design 
a full-bk>wn AppleScript Studio application. However, one thing 


display dialog "Please enter your secret access key:" 
default answer "" with hidden answer 


Please enter your secret access key; 


•I : 

( Cancel ) 


Figure 8. Display Dialog with a Hidden Answer 


While other new cf3inmand.s and lerminttlogy are available 
in llger, the last one that I wan! to mention in this article is the 
new system info conirtixind. Itiis command, which can lx? 
found in the MLscvlkncoufi Comimnds suite in the Standaid 
Additions scripting addition, will retrieve a variety of 
inffjrmation ab<.)i]t the current system configuration, including 
the system version, currenl user name, IP address, am! more. 
For example: 

system info 

-> lAppleScript version:"1.iO", AppleScript Studio 
version:"I.A". system version;"10.4". short user 
name: "bwaldle"* long user tismei^Ben llaidie". user ID:501. 
user locale:"en_0S", home directory:allas "Hacintosh 
IIP:Users:bwaidie, boot volume:"Macintosh HD", conputer 
name:"Ben Waldie's iMac G5", host name;"ben-waIdles-inac 
g5*local", IPv4 address:"192.i68-X.5", primary Ethernet 
address:"00:11:24:70:dh:be". CPU type:"PowerPC 970". CPU 
speed: 1599, physical metnoty:768j 

System Events 

You may already be familiar with the System Events 
application in Mac OS X. This application provides a centnil 
location for perfonning system-related tasks with AppleScript. In 
the past. System Events has been primarily used by developers 
to interact witli non-stTiptable application Interfaces via a 
Processes Suite, also known a.s Gill scripting. In Tiger, System 
Events' AppleScript dictionary has been expanded wiUi sime 
new suites of cla.sses and commands, which are sure to l^ecome 
quite [X)pular as well. 

A new QtJick7/nie File Suite, Movie File Suite, and Audio 
File Suite offer developers a way to access basic information 
alx>ut digital media files, wiihoui the need to open those media 
files in an associated application, such as QuickTime or iTimes. 
For example, the following code wiO retrieve information about 
a sfx?cified movie file. 

set theMovie to (chouse file of type "HuoV") as string 
tell application “System Events" 

properties of contents of movie file theMovie 

end tell 
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—> (madificatiDn tiae:date "Uadneaday, JaDtiary 3U 20DJ 
12130:38 AM'* stored stream;false* auto present;false* time 
scale:600* preferred volume;255. class:movie data* auto quit 
when done:false* bounds;tO* 0. 240* ISOh resizable:stop* 
looping:false* natural dimensions:!D* 0, 240* 1801* 
presentation mode:stop, data size;5816280. 
bref: **(110: //localhost/Users/bvaldie/Oesktop/starvars /mov' * 
creation time;date "Wednesday, January 31, 2001 12:30:34 
AM", preferred rate*65536* auto play:false* duration:26152. 
previev duration:0* preview timerOl 

A new XML Suite in System EvenLs provides a way to 
extract data frtjm an XML file, wiiJiuut Uie need to write 
complex parsin^^ code, or reson to using a scripting addition, tn 
addition^ a new Property List Suite c3n he used u> t|uickly and 
easily extract and set property item values in property list files. 
For example, the following code w^ill determine whether tabbed 
lirowsing is enabled in Safari, by extracting the value of the 
appropriate property in Safari’s property list file* 

set tbePropertyListFile to (path to preferences as string) & 

"com.apple.Safari.plist" 

tell application "System Events" 

value of property list item "tabbedBtowsing" of contents 
of property list file thePropertyListFile 
end tell 

-> true 

Database Events 

One feature that is sure to generate a lot of excitement in 
the A]3pleScript community i.s tire new Database Hvetils 
biickgroimd application* This application* which is located in 
.Sy.vfcirj > Lihnuy > Core^Services, can be u.sed lo 


prognunmalically generate SQL databa.ses. Thi*s capability 
opens up a whole new wcirid of possibilities for AppIeScripters 
who need a place to store data when running a script* leather 
than sumng diita in a property* or writing it to a text file* it can 
now l>e added to an SQL database, directly from AppleScript. 

For example* the following code will cTeate a new SQL 
database tn memory, and add two record.s with fields containing 
user data. The script will then kx’ate the record whose last 
name field matches my last name* "Waldie". 

tell application “Database Eveuta" 

set myDatabasa to tnaka new database with propartlas 
i name: “My DatabaBe'V) 
tell wyDatabase 

set inyFlratRecord to make new record with properties 
lnatDe;"Us^t Entry"} 

tell myfirstRecord 

make new field with properties tname:"FirstName** 
value:"Ben’' I 

make rvav field with properties fnane: “Las( Name", 
value:"Waldie"} 
end tell 

set nySecondHecord to make new record with properties 
I name:“User Entry"! 

tell mySecondXecord 

make new field with properties iname:“FtrstKaiiie", 
value;"John"I 

make new field with properties Inatne:"LastHarae"* 
value:"Smith"I 
end tell 

return every record whose value of field “LastMame* = 
"Waidie" 
end tell 
end tell 

-> [record id 137689274 of database “My Database" of 
application "Database Events"! 
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A diiuihawc ilmi is created or loaded in memoiy using 
Database Events will remam opened until it you close ii using 
the close command, or until the Database Events application 
tjtiits. When idle, Database Events will automatically quit after 
5 minutes of inactivity. However, tliis amount of time may ixi 
extended or reduced by modifying the quit delay pro|>eity of the 
Database Events application. For example, the following code 
sets Datalrasc Events to idle for 600 seconds, or 10 minutes, 
Ix^fore quitting. 

tell application "Database Events" 
eet quit delay to 600 
end tell 


fixes, l>e sure to check out the AppleScript releiise notes and die 
AppleScript Studio release notes, "f'hese diKaimenls can ['ki 
found in the Apple Devcit>per Connection Library at 
http://deve)opecapple.com/relea5enotes/applescript/. 

Also, some features, like Database Events and System 
Events changes, have nol been listed in the release notes. 
So, he sure to explore Tiger on your own, and begin 
learning about this, and other exciting new AppleScript 
capabilities. 

Until next lime, keep scripting! 

Till 


You may also cluxise to save a database using the save 
command in Datal>ase Events. By default, databases are saved 
into a Documents > Oafabases folder within your user folder. 
However, you may specify a different path, if desired, by 
specifying a folder path in the location property of a 
datalrase. For example, the foUowing code will create a 
dittabase, and then save it to tlie desktop: 

tell application "Database Events" 

set loyDatabase to tnake new database with properties 
I name:"My Database", location:path to desktop I 
save myDatabase 
end I ell 

Daiabase Events is shaping up to be a very useful 1 (k)I for 
AppleScript developers, Personally, 1 have only juM sianetl 
using it, but I can already see new ptissibilitics for how^ I store 
and access data from within my scripts, 

AppleScript Studio 

In addition to changes made to AppleScript in general in 
Tiger, AjjfjlcScript Studio has also undergone some changes 
as well. For developers creating projecis in AppleScript 
Studio, you will find irnprovements to data views and drag 
and drtjp, support for compiled scripts in Xcode projects, an 
enhanced code assistant, an updated dictionary hrt)wser, and 
more. 

Probably the most significant enhancement to Apple.S<Tipt 
Studio, though, is the ability to create Auiomaior actions. When 
creating a new project in Xccxle, a new template exists for an 
AppleScript‘based Automator action. Using this template, 
develojKTs am quickly build customized Automator actions, 
primarily using AppleScript. 

Next monili\s article will provide an introduction to 
Ap[ileScripl Studio, for those that have not yet gotten their feet 
%vel. Tile following month, we will dismss the steps involved in 
building a custom AppleScript-based Aotoiimtor action, using 
AppleScript Studio. 

In Closing 

As you cdn sec, the AppleScript team at Apple has 
continued to add great new' features and enhancements to 
AppleScript with yet another release of Mac OS X. Die topics 
covered in this article really only scratch the surface of these 
changes. Fur a comprehensive list of enhancements and bug 
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TLC Banks on HASP Security 



HASP...was the 
only Software 
Digital Rights 
Mangement 
solution we 
would consider... 
incredibly strong 
security, so easy 
to use. AA 


TLC Industries is the company behind FlexArcade^'^, 
the revolutionary game platform. PowerBall Billiards^'^, 
TLC's pool simulation, is quickly becoming an arcade 
favorite. When software is this hot, it has to be 
protected by the best. To enable safe, secure delivery to 
customers, TIC chose HASP, the world's #1 hardware- 
based software security solution*, 

As TLC's Maioka and Liu know, the HASP Envelope 
offers more layers of protection than any software 
security solution, making it the strongest file wrapping 
technology available. And the user-friendly interface 
makes the solution virtually plug-and-play. This means 
TLC can concentrate on developing great games—and 
leave the security to the security experts. 



IDCBuiietm ^31432,2004. 


Visit Aladdin,com/hasp ^ \ ^ 

to view HASP white papers/i| i(^^"\ 
an online demo, or to request 
a Developer Evaluation Kit. 

For informatiotr about TIC or PowerBall Billiards, visit tlclnd.com. 


North America: 1-800-562-2543, 847-818-3800 • UK 


Germany * Israel • Benelux • France 

O20l}S Afsddih Knowltdye Systcitis, Ud AldijUiri jnd HASP are tiadErrjArij of AiaiWiiq l id. 
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One System, One Funct/on, One Solid Performer 
r 5 Minutes From Unpack to First Backup—Literally 
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Whether you're responsible for a few deskside systems or the 
latest Hollywood blockbuster, the new bruAPP provides ultra- 
reliable, easy to use disk^to-dlsk (D2D) or disk-to-disk-to-tape 
(D2D2T) network-based backup, 

bruAPP complements TOLIS Group's BRU Server for Mac OS X and 
BRU LE for Mac OS X data backup and restore software products* 
bruAPP pricing starts at $2,999, 

To learn more about the bruAPP and BRU products for Mac OS X 
please call 480-505-0488 ext* 252 or visit TOLIS Group on the web 
at www,tolisgroup.com. 
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